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COMPUTER WITH A MEMORY SYSTEM FOR 
REMAPPING A MEMORY HAVING TWO 
MEMORY OUTPUT BUSES FOR HIGH 


RESOLUTION DISPLAY WITH SCROLLING OF 5 


THE DISPLAYED CHARACTERS 


BACKGROUND OF THE INVENTION 


The invention relates to the field of digital computers, 
particularly microcomputers, having video display ca- 
pabilities. 


Prior Art 


In the last few years, there has been rapid growth in 
the use of digital computers in homes by hobbyists, for 
small business and for routine engineering and scientific 
application. For the most part, these needs have been 
met with self-contained, relatively inexpensive mi- 
crocomputers or microprocessors with essential periph- 
erals, including disc drives and with relatively easy to 
manage computer programs. The design for computers 
for these needs requires considerable ingenuity since 
each computer must meet a wide range of applications 
and because this market is particularly cost conscious. 

A home or small business computer must, for exam- 
ple, operate with a number of different program lan- 
guages, including those requiring relatively large mem- 
ories, such as Pascal. The computer should interface 
with a standard raster scanned display and provide a 
wide range of display capabilities, such as high density 
alpha-numeric character displays needed for word pro- 
cessing in addition to high resolution graphics displays. 

To meet these specialize computer needs, generally 
requires that a relatively inexpensive microprocessor be 
used and that the capability of the processor be en- 
hanced through circuit techniques. This reduces the 
overall cost of the computer by reducing, for example, 
power needs, bus structures, etc. Another important 
consideration is that the new computers be capable of 
using programs developed for earlier models. 

As will be seen, the presently described microcom- 
puter is ideally suited for home and small business appli- 
cations. It provides a wide range of capabilities includ- 
ing advanced display capabilities not found in compara- 
ble prior art computers. 

The closest prior art computer known to applicant is 
commercially available under the trademark, Apple-II. 
Portions of that computer are described in U.S. Pat. No. 
4,136,359. 


SUMMARY OF THE INVENTION 


A digital computer which includes a central process- 
ing unit (CPU) and a random-access memory (RAM) 
with interconnecting address bus and data bus is de- 
scribed. One aspect of the present invention involves 
the increased capability of the CPU by allowing base 
page or zero page data to be stored throughout the 
memory. Alternate stack locations and an improved 
direct memory access capability are also provided by 
the same circuitry. Detection means are used for detect- 
ing a predetermined address range such as the zero 
page. This detection means causes a special register 
(Z-register) to be coupled into the address bus. The 
contents of this Z-register provide, for example, a 
pointer during direct memory access, or alternate stack 
locations for storing data normally stored on page one. 

The memory of the invented computer is organized 
in an unusual manner to provide compatibility with the 
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8-bit data bus and yet provide high data rates (16- 
bits/MHz) needed for high resolution displays. A first 
plurality of memory devices are connected to a first 
memory output bus; these memory devices are also 
connected to the data bus. The memory includes a sec- 
ond plurality of memory devices which are also con- 
nected to the data bus; however, the outputs of these 
second devices are coupled to a second output memory 
bus. First switching means permit the first and second 
memory buses to be connected to the display for high 
data rate transfers. Second switching means permit 
either one of the memory buses to be connected to the 
data bus during non-display modes. 

The addressing capability of the memory is greatly 
enhanced not only through bank switching, but through 
a novel remapping which does not require the CPU 
control associated with bank switching. In effect, the 
“unused” bits from one of the first and second memory 
buses are used for remapping purposes. This mode of 
operation is particularly useful for providing toggling 
between two separate portions of the memory. 

The display subsystem of the described computer 
generates video color signal in a unique manner. A 4-bit 
color code as used in the prior art, is also used with the 
described display subsystem. However, this code is used 
to generate an AC chrominance signal and a separate 
DC luminance signal. This provides enhanced color 
capability over similar prior art color displays. 


BRIEF DESCRIPTION OF THE DRAWINGS 


FIG. 1 is a block diagram showing the major compo- 
nents and subsystems of the invented and described 
microcomputer system. 

FIGS. 2 and 3 together show the central processing 
unit (CPU) and the architecture associated with this 
CPU, particularly the address bus and data bus. 

FIG. 2 is a circuit diagram primarily showing the 
address bus and the logic means associated with this 
bus. 

FIG. 3 is a circuit diagram primarily showing the 
data bus and its interconnection with the memory buses 
(A bus and B bus), bootstrap read-only memory, and 
input/output ports. 

FIGS. 4, 5 and 6 show the memory subsystem. 

FIG. 4 is a circuit diagram primarily showing the 
circuitry for selecting between address signals from the 
address bus and display counter signals. 

FIG. 5 is a circuit diagram primarily showing the 
generation of various “select” signals for the memory 
devices. 

FIG. 6 is a circuit diagram showing the organization 
of the random-across memory and its interconnection 
with the data bus and memory output buses. 

FIGS. 7 and 8 illustrate the display subsystem of the 
invented computer. 

FIG. 7 is a circuit diagram showing the circuitry for 
generating the digital signals used for the video display. 

FIG. 8 is a circuit diagram of the circuitry used to 
convert the digital signals to analog video signals. 

FIG. 9 is a graph of several waveforms used to de- 
scribe a prior art circuit and the circuit of FIG. 8. 


DETAILED DESCRIPTION OF THE 
INVENTION 


A microcomputer system capable of driving a raster 
scanned video display is disclosed. In the following 
description, numerous specific details such as specific 
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part numbers, clock rates, etc, are set forth to provide a 
thorough understanding of the present invention. How- 
ever, it will be obvious to one skilled in the art that the 
inventive concepts described in this patent may be prac- 
ticed without these specific details. In other instances, 
well-known circuits have been shown in block diagram 
form in order not to obscure the present invention in 
unnecessary detail. 

Referring first to FIG. 1, in general the described 
computer includes a central processing unit (CPU) 65, 
its associated data bus 42, address bus 46, a memory 
subsystem and a display subsystem 58. 

The address bus 46 from the CPU is coupled to the 
memory subsystem to permit the selection of locations 
in memory. Some of the address signals pass through a 
multiplexer 47. For some modes of operation, signals 
from a register 52 are coupled through the multiplexer 
47 onto the bus 46. The register 52 is identified as the 
Z-register and is coupled to the multiplexer 47 by the Z 
bus. The general description of the multiplexer 47 and 
its control by the logic circuit 41 are described in detail 
in conjunction with FIG. 2. In general, the circuitry 
shown to the left of the dotted line 53 is included in 
FIG. 2 while the CPU 65, memory 50, data bus 42 and 
multiplexer 43 are shown in detail in FIG. 3. 

The address bus N1 is coupled to the read-only mem- 
ory 50. The output of this memory is coupled to the 
computer’s data bus 42. The read-only memory (ROM) 
50, as will be described, stores test routines, and other 
data of a general bootstrap nature for system initializa- 
tion. 

The data bus 42 couples data to the random-access 
memory (RAM) 60 and to and from I/O ports. This bus 
also couples data to the Z-register 52 and other com- 
monly used registers not illustrated. The data bus 42 
receives data from the RAM 60 through the A bus and 
B bus which are selected by multiplexer 43. The periph- 
eral Bus N2 is used, as is better illustrated in FIG. 3, for 
coupling to peripherals. 

The memory subsystem is shown in detail in FIGS. 4, 
5 and 6. The address control means which receives 
addresses on bus 46, makes the final selection of mem- 
ory locations within the RAM 60. Bank switching, 
addressing for display purposes, scrolling and other 
memory mapping is controlled by the address control 
means 59 as will be described in greater detail in con- 
junction with FIGS. 4 and 5. The PAM 60 is shown in 
detail in FIG. 6. The counter 58 which is sychronized 
with the horizontal and vertical display signals, pro- 
vides signals both to the address control means 59 and 
to the display subsystem 48. 

The display subsystem receives data from the RAM 
60 on the A bus and B bus and converts these digital 
signals to video signals which control a standard raster 
scanned display. A standard NTSC color signal is gen- 
erated on line 197 and a black and white video signal on 
line 198. The same signals used to generate these video 
signals can be used to generate separate red, green, blue 
(RGB) video signals. The display subsystem 48 receives 
numerous timing signals including the standard color 
reference signal shown as 3.5 MHz (C3.5M). This sub- 
system is described in detail in FIGS. 7 and 8. 


COMPUTER ARCHITECTURE 


In the presently preferred embodiment, the CPU 65 
(microprocessor) employed with the described com- 
puter is a commercially available component, the 
6502A. This 8-bit processor (8-bit data bus) which has a 
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16-bit address bus is shown in FIG. 3 with its intercon- 
nections to the remainder of the computer. The pin 
number for each interconnection is shown adjacent to 
the corresponding line. In many cases, the nomencla- 
ture associated with the 6502A (CPU 65) is used in this 
application. For example, pin 6 receives the nonmaska- 
ble interrupt signal (NMI), and pin 4 is coupled to re- 
ceive the interrupt request signal (IRQ). Some of the 
signals employed with the CPU 65, which are well- 
known in the art, and which are not necessary for the 
understanding of the present invention are not de- 
scribed in detail in this application, such as the various 
synchronization signals and clocking signals. The ad- 
dress signals from the CPU 65 are identified as Ag~A7 
and Ag-A\s. The data signals associated with the CPU 
65 are shown as Do-D7. As will be apparent to one 
skilled in the art, the inventive concepts described in 
this application may be employed with other micro- 
processors. 

Referring now to FIGS. 2 and 3, the general architec- 
ture, particularly the architecture associated with the 
CPU 65 can best be seen. The address signals Ag-A7 are 
coupled to a buffer 103 by the bus shown primarily in 
FIG. 2. These address signals are also coupled to the 
ROM 50. The signals Ao-A7 after passing through the 
buffer 103 are coupled to the memory subsystem. The 
address signals Ag-A1s (higher order address bits) are 
coupled through lines shown in FIG. 2 to the multiplex- 
ers 47a and 47b. The contents of the Z-register 52 of 
FIG. 1 is also connected to the multiplexers 47a and 476 
through the Z-bus (Z|-Z7). The multiplexers 47a and 
47b allow the selection of either the signals As-A15 
from the CPU 65 or the contents of the Z-register 
(Z}-Z7) for addressing the RAM 60. The output of 
these multiplexers are shown as Ag-Aj5; this designa- 
tion is used even when the Z-bus is selected. Note in the 
case of the Zo signal, this signal is coupled to the multi- 
plexer 47a through the exclusive OR gate 90 for reasons 
which are explained later. The address signals Ag-A11 
are also coupled to the ROM S50, thus the signals 
Ao-Ai, are used for addressing the ROM 50. The sig- 
nals Ag~A15 are connected to the logic circuit shown in 
the lower left-hand corner of FIG. 2; this logic circuit 
corresponds to the logic circuit 41 of FIG. 1. 

The input and output data signals from the CPu 65 
are coupled by a bidirectional bus to the bidirectional 
buffer 99 (FIG. 3). This buffer is selectively disabled by 
gate 100 to allow the output of ROM 50 to be communi- 
cated to CPU 65 and during other times not pertinent to 
the present discussion. The direction of flow through 
the buffer 99 is controlled by a read/write signal cou- 
pled to the buffer through inverter 101. Data from the 
CPU 65 is coupled through the buffer 99 and bus 42 to 
the RAM 60 or to I/O ports. Data from the RAM 60 is 
communicated to CPU 65 or bus N2 from the A bus and 
B bus through the buffer 99. The 4 lines of the A bus and 
4 lines of the B bus are coupled to the multiplexer 43a. 
Similarly, the other 4 lines of the A and B buses are 
coupled to the multiplexer 43d. Multiplexers 43a and 
43 select the 8 lines of the A bus or B bus and commu- 
nicate the data through to buffer 99 and bus 42. These 
multiplexers are selectively disabled (for example, dur- 
ing writing) by gate 102. As will be described later, the 
16 lines of the A bus and B bus permits the reading of 
16-bits from the RAM at one time. This provides a data 
rate of 16-bits/MHz which is necessary, for example, 
for an 80 character per line display. The data is loaded 
into the RAM 60, 8-bits at a time. 
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The ROM 59, as mentioned, stores test programs, 
data needed to initialize various registers, character 
generation data (for RAM 162 of FIG. 7) and other 
related data. Specific programs employed in the pres- 
ently preferred embodiment of the computer are set 
forth in Table 1. The ROM 50 is selected by control 
signals coupled to its pins 18 and 20, identified as signals 
ROM SEL and T ROM SEL. Any one of a plurality of 
commercially available read-only memories may be 
used for the ROM 50. In the presently preferred em- 
bodiment, commercially available Part No. SY2333 is 
used. 

Referring now to this logic circuit (lower left-hand 
corner of FIG. 2), the NAND gate 81 receives the 
address signal Ag and also the alternate stack signal 
identified as ALT STK. The output of this gate pro- 
vides one input to the AND gate 87. The Ag signal is 
also coupled through the inverter 82 to one input termi- 
nal of the NAND gates 85 and 86. The address signals 
Ag and Ajo are coupled to the input terminals of the 
NOR gate 83. The output of this gate is coupled to one 
input terminal of the NAND gates 85 and 86 and the 
AND gate 87. The address signals A11-415 are coupled 
to the input terminals of the NOR gate 84. The signal 
A} is also coupled to an input terminal of the NAND 
gate 85. 

The outputs of the AND gates 87 and 88 (through 
NOR gate 89), controls the multiplexers 47a and 475. 
When the output of gate 89 is low the Z-bus is selected, 
otherwise the address signals from the CPU 65 are se- 
lected. 

The logic circuit above-described, along with the 
Z-bus and Z-register provide enhanced performance for 
the computer. First, this circuit permits the zero page or 
base page data to be stored throughout the RAM 60 
rather than just on zero page. Secondly, this circuit 
enables addressing of alternate stack locations (other 
than page one). Lastly, this circuit through the Z-regis- 
ter provides a RAM pointer for direct memory access 
(DMA). 

Assume for purposes of discussion that the CPU 65 is 
addressing the zero page of memory. That is, the higher 
order address bits Ag-A1s5 are all zeros. The zeros for 
Ag-Ats are detected by the gates 83 and 84. If all the 
inputs to these gates are zeros, the outputs of these gates 
are high which condition is communicated to the gate 
87. Ag which is also low, insures that the output of gate 
81 will be high. Thus, all the inputs to gate 87 are high, 
causing the signal at the output of the gate 89 to drop. 
When this occurs, the Z-bus is selected. Instead of all 
the binary zeros from the CPU being coupled to the 
main memory (RAM 60), the contents of the Z-register 
form part of the address for the memory. Therefore, 
even though the CPU 65 has selected the zero page, 
nonethelessdata may be written into or from any loca- 
tion of RAM 60 (including the zero page). This en- 
hances the performance of the CPU, since for example, 
the time consumed in shifting data to and from a single 
zero page is minimized. 

Normally, the CPU 65 selects page one for stack 
locations. This occurs when Ag is high and Ag-A\5 are 
low. Assume first that the alternate stack locations have 
not been selected. Both inputs to gate 81 are high and its 
output is low. The low input to the gate 87 prevents the 
selection of the Z-bus. Thus, for these conditions the 
address signals Ao-A7 select stack locations on page 
one. 


Apple Computer Inc. Patent : 4 383 296 


4,383,296 


6 

Next assume that page one has been selected by the 
CPU and that the ALT STK signal is low, indicating 
the alternate stack locations are to be selected. (A flag is 
set by the CPU to change the ALT STK signal). Since 
the ALT STK signal is low and Ag is high, a high out- 
put occurs from the gate 81. All the inputs to gates 83 
and 84 are low, therefore, high outputs occur from both 
these gates. The conditions of gate 87 are met, causing 
a high output from this gate and lowering the output 
from the gate 89. The Z-bus is thus selected by the 
multiplexers 47a and 47b. This allows the contents of 
the Z-register to be used as alternate locations. Non- 
zero page locations are assured by inverting Ag. The 
exclusive OR gate 90 acts as a selective inverter. If Ag 
is high and Zo is low, then Ag at the output of the multi- 
plexer 47a will be low. Note that during zero page 
selection when Ag is low, the Zo signal is directly com- 
municated through gate 90 to the output of multiplexer 
47a. 

Thus, the logic circuits along with the ALT STK 
signal allows alternate stack locations to be selected 
through the Z-bus. This further enhances the perfor- 
mance of the CPU which would otherwise be limited to 
page one for stack locations. 

The logic circuit of FIG. 2 is also used along with the 
Z-register to provide a pointer during direct memory 
access (DMA). Assume that direct access to the com- 
puter’s memory is required by a peripheral apparatus. 
To initiate the DMA mode the CPU provides an ad- 
dress between F800 and R8FF. Through a logic circuit 
not illustrated in FIGS. 2 and 3, the ROM SEL signal is 
brought low for addresses between F000 and FFFF. 
This signal is communicated to gate 93 and causes the 
output of gate 92 to rise (DMA 1 is high at this time). 
This rise in potential is communicated to one input of 
the gate 85. Additionally, gate 85 senses that the address 
bits Ag, Ag and Ajgare low. This information is coupled 
to gate 85 through the inverter 82 and the NOR gate 83 
as high signals. Also the fact that Aj, is high is directly 
communicated to gate 85. Thus, with the address be- 
tween F800 and F8FF the DMA OK signal drops in 
potential. This is sensed by the peripheral apparatus 
which in turn causes the DMA 1 signal to drop and 
provides a ready signal to the CPU 65. With the com- 
pletion of this handshake, data may begin to be trans- 
ferred to the RAM. 

The DMA I signal through gate 93 and inverter 93 
forces the T ROM SEL signal low. This signal in addi- 
tion to being communicated to the ROM 50, is coupled 
to the buffer 99 through gate 100, disabling this buffer 
(during the reading of ROM 50). Also, the ready signal 
causes the CPU to come to a hard stop. Importantly, the 
DMA I signal, after passing through the inverter 94 and 
the gates 88 and 89, assures the selection of the Z-regis- 
ter. The contents of the Z-register are fixed and provide 
a pointer to a page in the RAM. 

Under the above conditions, the CPU increments the 
lower 8-bits of the address signal. The ROM 50 fur- 
nishes the instructions for incrementing the address, 
specifically SBC #1 and BEQ. The peripheral appara- 
tus provides the data or receives the data in synchroni- 
zation with the CPU operation. The peripheral also 
furnishes a read/write signal to indicate which opera- 
tion is to occur. Data is then written into RAM via bus 
N2 and bus 42, or read from RAM via the A and B buses 
and bus N2. 

Importantly, with the above DMA arrangement, 
addresses from the peripheral apparatus are not neces- 
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sary and the Z-register is used to provide a pointer to a 
page in RAM 60. 


MEMORY SUBSYSTEM 


The memory sybsystem shown in FIG. 1 as the ad- 
dress control means 59 and RAM 60 is illustrated in 
detail in FIGS. 4, 5 and 6 as mentioned. In FIGS. 4 and 
5, the memory control means is shown, while in FIG. 6 
the memory devices and their organization are illus- 


trated. The address control means of FIGS. 4 and 5 10 


receives the address signals from the CPU 65 (Ao-Ai15), 
the count in the vertical and horizontal counters 
(counter 58 of FIG. 1) which are used during display 
modes, control signals from the CPU and other signals. 
In genreal, this control means develops the address 
signals which are coupled to the RAM of FIG. 6 includ- 
ing the column address and row address signals, com- 
monly referred to as CAS and RAS. Other related func- 
tions are also shown in FIGS. 4 and 5, such as the cir- 
cuitry which provides display scrolling, indirect RAM 
addressing and memory mapping. 

The CPU of FIG. 3 provides a 16-bit address for 
addressing the memory. Under ordinary circumstances 
this address limits the memory capacity to 64K bytes. 
This size memory is insufficient in many applications, as 
for example, to effectively use the Pascal program lan- 
guage. As will be described in greater detail, the address 
control means of FIGS. 4 and 5 enable the use of a 
memory having a 96K byte or 128K byte capacity. One 
well-known technique which is used with the present 
invention for increasing this capacity is bank switching; 
this switching occurs under the contol of the CPU. In 
addition, the address control means uses a unique indi- 
rect addressing mode which provides the benefits of 
bank switching, however, this mode does not require 
CPU control. This greately enhances CPU operation 
with the larger memory (as will be described) when 
compared to the CPU controlled bank switching. 

Referring first to FIG. 6, the RAM configuration is 
illustrated for a capacity of 96K bytes. The memory is 
organized into six rows, each of which includes eight 
16K memory devices such as rows 111 and 112. In the 
presently preferred embodiment, Part No. 4116 MOS 
dynamic RAMs are used. (The pin designations and 
signal designations refer to this memory device.) Obvi- 
ously, other memory devices may be employed. 

Input data to these memory devices 106 is provided 
from the bus 42. Each line in the bus 42 is connected to 
the data input terminal of one device 106 in each row. 
The interconnection of this bus with each of the mem- 
ory devices is not shown in FIG. 6 in order to overcom- 
plicate this drawing. By way of example, however, line 
107 connects the data bit D7 to the data input terminal 
of one of the memory devices in each of the six rows. 

Three rows of devices 106 have their output termi- 
nals coupled to the A bus, and three rows are similarly 
coupled to the B bus. By way of example, line 108 con- 
nects three output terminals of devices 106 to the DB7 
line of the B bus while line 109 connects three output 
terminals of the devices 106 to the DA7 line of the A 
bus. 

The described memory devices 106 are each orga- 
nized as a 16KX1 memory. Thus, each device receives 
a 14-bit address which is time multiplexed into two, 
7-bit addresses. This multiplexing occurs under the 
control of the CAS and RAS signals as is well-known. 
The lines coupling the address signals to each of the 
devices in FIG. 6 are not illustrated. However, in the 
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lower right-hand corner of FIG. 6, the various signals 
applied to each device (including the address signals), 
along with the corresponding pin numbers are shown. 
Other circuitry not illustrated is the refresh control 
circuitry which operates in a well-known manner in 
conjunction with the CAS, RAS and address signals to 
refresh the dynamic devices. 

Each row of memory devices 106 receives a unique 
combination of CAS and RAS signals. For example, 
row 111 receives CAS 5, 7 and RAS 4, 5; similarly, row 
112 receives CAS 0 and RAS 0, 3. The generation of 
these CAS and RAS signals is described in conjunction 
with FIG. 5. These signals (along with the 14-bit ad- 
dress signals) permit the selection of a single 8-bit loca- 
tion in the 96K byte memory (for writing) and also the 
selection (for reading) of 16-bit locations. 

The memory of FIG. 6 may be expanded to a 128K 
byte memory by using 32K memory devices, such as 
Part No. 4132. In this case, four rows of eight, 32K 
memory devices are used with each row receiving two 
CAS and RAS signals. 

Before reviewing FIG. 4, a general understanding of 
the organization of the display is helpful. The display, 
during certain modes, is organized into 80 horizontal 
segments and 24 vertical segments for a total of 1920 
blocks. 11-bits of the counter 58 of FIG. 1 are used as 
part of the address signals for the memory to access data 
for displaying during these modes. These counter sig- 
nals are shown in FIG. 4 as Ho-Hs and Vo-V4. During 
other display modes each horizontal segment is further 
divided into 8 segments (e.g. for displaying 80 alpha 
numeric characters per line). This requires 3 additional 
vertical timing signals shown as V4, Vg and Vc in 
FIGS. 4 and 7. 

Often in the prior art, two separate counters are used 
to supply the timing/address signals for accessing a 
memory when the data in the memory is displayed. The 
count in one counter represents the horizontal lines of 
the screen (vertical count) and the other the position 
along each line, (horizontal or dot count). In many prior 
art displays the most significant bit of the dot counter is 
used to increment the line counter. Data in memory 
intended for display is mapped with a one-to-one corre- 
lation to the counts in these counters. In another prior 
art system (implemented in the Apple-II computer sold 
by Apple Computer, Inc.) this one-to-one correlation is 
not used. Rather, to conserve on circuitry, a single 
counter is employed and a more dispersed mapping is 
used in the memory. (Note that where a maximum honi- 
zontal count of 80 is used, this number cannot be repre- 
sented by all ones in a digital counter and thus the verti- 
cal counter cannot easily be incremented by the most 
significant bit in the horizontal counter.) Since this 
more dispersed mapping technique is part of the prior 
art and not critical to an understanding of the present 
invention, it shall not be described in detail. However, 
the manner in which it is implemented shall be discussed 
in conjunction with the adder 114 of FIG. 4. For pur- 
poses of discussion, the signals from the counter 58 of 
FIG. 1 are designated as either vertical (V) or horizon- 
tal (H). 

Referring now to FIG. 4, the selection of either the 
counter signals on the address signals from the CPU is 
made by the multiplexers 116, 117, 118 and 119. Each of 
these commercially available multiplexers (Part No. 
153) couples one of four input lines to an output line. 
There are eight inputs to multiplexers 116, 117 and 118 
and the outputs of these multiplexers provide the ad- 
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dress signals for the memories (ARO through ARS). The 
multiplexer 119 has four inputs on its pins 3, 4, 5, 6 and 
provides a single output on pin 7, the AR6 address 
signal. (The signals supplied to pins 11, 12 and 13 of 
multiplexer 119 are for clamping purposes only.) 

The AX signal is applied to the pin 14 of each of the 
multiplexers. The signal on this line and the signal ap- 
plied to pin 2, determines which of the four inputs is 
coupled to each of the outputs of the multiplexers. The 
AX signal is a RAM timing signal for clocking the first 
7 bits and second 7 bits of the multiplexed 14-bit address 
applied to each of the memory devices 106. The other 
control signal to the multiplexers is developed through 
the AND gate 123. The inputs to this gate are the dis- 
play signal (DSPLY) which indicates that the computer 
is in a display mode and a clocking signal, specifically a 
1MHz timing signal (C1M). The output of the AND 
gate 123 determines whether the address signals from 
the CPU or the signals associated with the counter 58 of 
FIG. 1 are selected. 

Assume for purposes of discussion that the display 
has not been selected, and thus, the output of gate 123 is 
low. The AX signal then selects for pin 7 of multiplexer 
116 first the address signal Ap and then Ag. Likewise, 
each of the multiplexers selects an address signal (ex- 
cept for those associated with exclusive OR gates 124 
and 125 which shall be discussed). If the display signal 
is high and an output is present from the gate 123, then, 
by way of example, the AX signal first causes the Hi 
signal and then the V) signal to be connected to the 
AR1 address line. Similarly, signals corresponding to 
the vertical and horizontal count are coupled to the 
other address lines during display modes. 

The adder 114 is an ordinary digital adder for adding 
two 4-bit digital nibbles and for providing a digital sum 
signal. A commercially available adder (Part No. 283) is 
employed. The carry-in terminal (pin 7) is grounded 
and no carry-outs occur since one of the inputs (pin 12) 
is grounded. The adder sums the digital signal corre- 
sponding to H3, H4 and Hs with the digital signal corre- 
sponding to V3, V4, V3, V4. The resultant sum signal is 
coupled to the multiplexers 116, 117 and 118 as illus- 
trated. the summing of these horizontal and vertical 
counter signals is used to provide the more dispersed 
mapping as previously discussed. 

The adder 121 is identical to adder 114 and is coupled 
to sum the three least significant vertical counter bits 
from the counter 58 (FIG. 2) with the signals VA1, VB1 
and VC1. The sum is selected by the multiplexer 120 
during the high resolution display modes and also dur- 
ing scrolling as will be described. These sum signals are 
coupled to the multiplexers 117, 118 and 119. During 
the low resolution display modes, the multiplexer 120 
couples ground signals or the page 2 signal 2) to the 
multiplexers 117, 118 and 119. (The PG2 signal is used 
for special mapping purposes, not pertinent to the pres- 
ent invention.) During the high resolution modes when 
the display is not being scrolled, the VA1, VB2 and 
VB3 signals are at ground potential and thus no sum- 
ming occurs within adder 121 and the VA, VB and VC 
signals are coupled directly to the multiplexers 117, 118 
and 119. 

The address signals Ajo, A11, and A13 from the CPU 
are coupled to the multiplexers 117, 118 and 119, re- 
spectively, through exclusive OR gates 124, 125, and 
126, respectively. The other input terminals to gates 124 
and 125 receive the C3 signal, while the other input 
terminal of the gate 126 receives the C; signal. (The 
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development of the C; and C; signals is illustrated in 
FIG. 5.) The gates 124, 125 and 126 provide mapping 
compensation within the memory. As the computer and 
memory are presently implemented, the sequence in 
which the various portions of the display are generated 
is not the same as the sequence in which the data is 
removed from memory for display. These gates provide 
compensating addresses and, in effect, cause a remap- 
ping so that the proper sequence is maintained when 
data is read from the memory for the display. These 
gates are shown to provide a complete disclosure of the 
presently preferred embodiment, however, they are not 
critical to the present invention. 

In operation, the circuitry of FIG. 4, as mentioned, 
selects the address signals which are applied to each of 
the memory devices, either from the CPU or counter if 
the display mode is selected. It should be noted that not 
all of the address bits from the CPU are coupled to the 
multiplexers 116 through 119. Some of these address 
bits, as will be described in conjunction with FIG. 5, are 
used to develop the various CAS and RAS signals and 
thus select different rows within the memory of FIG. 6. 

The scrolling operation which is used is somewhat 
unusual in that each line of the display is separately 
moved up (line-by-line) with one line of data in memory 
being moved for each frame. This technique provides a 
uniform, esthetically pleasing, scroll. Scrolling the 
screen one line per frame can be achieved by moving all 
the data in the memory into a new position for each 
frame. This would be very time consuming and imprac- 
tical. With the described technique, only one-eighth of 
the data in the memory is moved for each new frame. 

Referring to the adder 121, as mentioned, the signals 
Va, Ve Vc are the three least significant vertical 
counter bits from the counter 58. These bits or counts, 
by way of example, represent the 8 horizontal lines of 
each character. In adder 12, a 3-bit digital signal, VA1, 
VB1 and VC1, is added to the count from counter 58. 
This 3-bit signal is constant during each frame, how- 
ever, it is incremented for each new frame. 

During a first frame, 000 is added to the vertical 
count. During a second frame, 001 is added; and during 
a third frame, 010 is added, and so on. By adding this 
digital signal to the count from counter 58, the ad- 
dresses to the memory are changed in the vertical sense. 
During the first frame when 000 is added, the display 
remains unaffected. During the next frame, when 001 is 
added to the vertical count, instead of first displaying 
the first line of a character, the second line of each 
character is displayed at the top of each character space 
and each subsequent line of the character is likewise 
moved up one line. If data in memory is not moved, the 
first line of the character would appear at the bottom of 
each character. Note when 001 is added to 111 from the 
counter, 000 results. Thus, the first line of characters 
would be addressed when the beam is scanning the 
eighth line of characters. To prevent this, the data cor- 
responding to the first line of each character is moved in 
memory for this frame. The first line of one character is 
moved up and becomes the bottom line of the character 
directly above it. When 010 is added, the process is 
again repeated. For example, the third line of each char- 
acter is first displayed in each character space and the 
second line of each character is moved up to become 
the bottom line of the character directly above it. This 
process is repeated to scroll the data. The movement of 
data in memory is controlled by the CPU in a well- 
known manner. 
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Thus, through use of adder 121, an even, continuous 
scroll is obtained without moving all the data in mem- 
ory for each frame. Rather, only 4th of the data is 
moved for each frame. ; 

Referring now to FIG. 5, the circuitry used to extend 
the addressing from the CPU is illustrated. In general, 
the CAS signals are generated by the ROMs 127 and 
128. The signals are generated by the ROM 132. 
The multiplexer 130 allows the selection of either the 
bank switching signals, or the unique indirect address- 
ing mode when “bank switching” occurs without direct 
commands from the CPU. 

The CAS ROM 127 receives as an address the fol- 
lowing signals: PRAS,63, PRAS 1,2 AY, DHIRES, 
R/W, Au, Ai3, Ais, and Ais. As the PRAS@, 3 and 
PRAS 1, 2 represent the RAS signals being used. These 
signals are high when the respective RAS signal is ac- 
tive. 

AS previously mentioned, the AY signal is high for 
display modes and the DHIRES signal is high for high 
resolution display modes. The CAS ROM 128 receives 
as address signals the ABK1, ABK2, and ABK3 signals 
and also DHIRES, AY, IND, Aji, A13, Aa, and A415. 

The ROMS 127 and 128 are programmed to imple- 
ment the following equations. 


PCASO =(PRASO,3-(DHIRES-AY + AY-(AIS-AI- 
4-A13-AT1-R/WN + AI8-A14-A13-R/WN + A1- 
8-A14-A13+ A15-A14-A13-Al]))) 


PCAS2=(DHIRES-AY + AY-(ABKI-ABK2-ABK- 
3.IND + ABK1-ABK2.ABK3)-(A15-A14- 
)+ AY-IND-ABK1-ABK2-ABK3.A15-(A14-A13- 
+A14AT3)) 


PCAS3=PRASO. fae ee 
3.(DHIRES.-AY + AY(A15-A14-A13-A11 + A1- 
5-A14-A13-Al1 + A15-A14-A13))) 


PCAS4,6=(AY-IND-ABK3.A15.(ABK1-ABK- 
2+ABK1)-ABK2) 
(AT4-A13 + A14-A13) + AY-IND-ABK3-(ABK- 
2-ABK1.A15+ ABK2-ABK1 + ABK2.ABK- 
1-A18).A14+ AY-IND-ABK1-ABK2-ABK3-(A1- 
3.A14-A13+A15 
AI14A13)+ AY-IND-ABK3-ABK2.(A15-ABK- 
14+ A15-ABK1)-(A14-A13 + A14-A13)) 


PCASS, 
7,=(AY-IND-ABK3-(ABK1-ABK2+ ABK1- 
ABK2)(A1S-A14-A13 + A15-A14-A13)+AY-I- 
ND-ABK3.(ABK2-ABK1.A15 + ABK2-ABK- 
1+ ABK2-ABK1-A18)-A14+AY-IND-ABK- 
1-ABK2-ABK3-(A1S-A14)+ AY-IND-ABK- 
3-ABK2-(A15-ABK1+ A15-ABK1)-(A14-A 13- 
+A14¢AT3)) (5) 

In effect, these ROMs are programmed to allow selec- 

tion of predetermined rows in the memory, based on the 

address signals Ajo, Ai3, A14 and Ajs, (ignoring for a 

moment the contribution of the RAS signals and the 

other signals appearing in the equations). 

The outputs of the CAS ROMs 127 and 128 are cou- 
pled to the register 131. Register 131 is a commercially 
available register which permits the enabling of output 
signals (Part No. 374). During accessing of the memory 
the various CAS signals (CAS 0 through CAS 7) are 
coupled to the memory of FIG. 6 to permit selection of 
the appropriate memory devices. The signal USELB 
from CAS ROM 127 through register 131 selects either 
the A bus or B bus. This signal is coupled to the multi- 
plexers 43a and 436 of FIG. 3. 

During normal operation, the multiplexer 130 selects 
the bank switching signals BCKSW 1 through BCKSW 
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4. These four signals (or alternatively four signals from 
the A bus) provide four of the inputs (address signals) to 
the ROM 132. The other inputs to this ROM are the 
DHIRES, Z PAGE, PA8, PA15, RFSH (refresh), and 
AY signals. These address signals select the RAS 0, 3; | 
RAS 1, 2; RAS 4, 5 and RAS 6, 7 signals. The ROM 132 
is programmed to implement the following four equa- 
tions. 


PRASO,3=AY-(DHIRES + RFSH) + (ABK4(Z 
Page-PA8)) + ABK1-ABK2-ABK3)-AY 


PRAS1,2=AY(DHIRES + RFSH) + AY-(ABK- 


1-ABK2-ABK3-(ABK4-(ZPAGE-PA8)-PAI5- 
)+ ABK1-ABK2-ABK3)+A Y-ABK3-(ABK- 
1T-ABK2-ABK4(ZPAGE-PA8)-PA15 + ABK- 
1-ABK2(ABK4-(ZPAGE.PA8)-PAI8) 


PRAS4,5 = RFSH-AY + AY-ABK2-ABK3(ABK- 
T-ABK4(ZPAGE-PA8)-PA15 + ABK1(ABK- 
4.(ZPAGE-PA8)-PA15) 


PRAS6,7=RFSH-AY +AY-ABK3-(ABK1-ABK- 
2-ABK4(ZPAGE-PA8)-PA15+ ABK1-ABK- 
24ABK4-(ZPAGE-PA8)-PAI5) 


Thus, the bank switching signals (along with the other 
input signals to ROM 132) select predetermined rows in 
memory in conjunction with the CAS signals. 

The output signals of the ROM 132 are coupled 
through the NAND gates 142, 143, 144 and 145 to the 
memory. The other input terminals of these gates re- 
ceive the RAS timing signal. In this manner, the output 
signals of the ROM 132 are clocked through the gates 
142 through 145 to provide the RAS signals shown in 
FIGS. 5 and 6. 

An important feature to the presently described com- 
puter is provided by the circuitry shown within the 
dotted line 146. The AND gate 148 receives, at its input 
terminals, the DA7, A12, and C3 signals. The NOR gate 
149 receives the zero page and A15 signal. The output of 
gate 149 provides one input to the gate 148 and also one 
input to the AND gate 150. The output of gate 148 
provides another input signal to gate 150 and this signal 
(line 153) is one of the two control signals coupled to 
the multiplexer 130. The AND gates 150 and 151 also 
receive a SYNC signal and the ¢po signal. The output of 
the gates 150 and 151 are coupled to a NOR gate 152 
with the output of the gate 152 (line 154) coupled to the 
other control terminal of the multiplexer 130. 

The gates 150, 151 and 152 effectively form a clock 
for multiplexer/register 130 (multiplexer 130 is a com- 
mercial part, Part No. 399, which effectively is a regis- 
ter/multiplexer). This selects the lower four input lines 
to the multiplexer 130. However, because of the syn- 
chronization signal applied to gate 151, the multiplexer 
130 selects the bank switching signals each time an OP 
code is fetched by the CPU. 

To understand the operation of the circuit shown 
within the dotted line 146 it should be recalled that the 
memory of FIG. 6 provides a 16-bit output. As men- 
tioned, during certain display modes, 16-bits/msec. are 
needed for display purposes. In nondisplay modes, only 
8-bits are required, particularly for interaction with the 
CPU. When the memory is addressed by the CPU dur- 
ing the indirect addressing modes the data on the A bus 
is not ordinarily used. However, with the circuitry 
shown within the dotted line 146, this otherwise “un- 
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used” data is put to use to provide the equivalent of the 
bank switching signals through multiplexer 130. 

Whenever the CPU selects a predetermined range of 
addresses, the multiplexer 130 selects the equivalent of 
the bank switching signals from the A bus provided 
DAT is high. (This occurs when addressing as zero page 
the address space -1800 through 1FFF.) Once the signal 
on line 153 is high it is latched through gates 150, 151 
and 152 causing the multiplexer 130 to select the four 
bits from the A bus (assuming the timing signals are 
high). Even if the next reference from the CPU is not to 
this special address range, the multiplexer 130 nonethe- 
less remains latched with the four bits from the data bus. 
Once the SYN pulse drops, however, which is an indi- 
cation that an OP code is being fetched, the signal on 
line 154 rises in potential, causing the multiplexer to 
switch back to the bank switching signals. 

Effectively, what occurs is that when the CPU selects 
this special address range, (and provided DA7 is high) 
the bits DAO through DA3 which are stored in mem- 
ory, cause a remapping, that is, the address from the 
CPU accesses a different part of the memory. With the 
fetching of each OP code, the mapping automatically 
returns to the bank switching signals. Importantly, the 
remapping, which occurs is controlled by the bits stored 
in the RAM (DA® through DA3). Thus, with the 
remapping information stored in RAM, toggling can 
occur between different portions of the memory with- 
out requiring bank switching signals, or the like from 
the CPU. This enhances the CPU’s performance since 
CPU time is not used for remapping. Additionally, it 
provides an easy tool for programming. 

For some program languages it is desirable to sepa- 
rate data and the program into separate portions of the 
memory. For example, the 128K memory can be di- 
vided into two 64K memories, one for program and one 
for data. Switching can occur between these memory 
portions without the generation of bank switching sig- 
nals by the CPU with the above described circuit. This 
arrangement is particularly useful when using the Pas- 
cal program language. 


DISPLAY SUBSYSTEM 


The display subsystem 48 of FIG. 1 receives data 
from the A bus and B bus and converts the data into 
video signals which may be used for displaying alpha- 
numeric characters or other images on a standard raster 
scanned cathode ray tube display. The display subsys- 
tem 48 specifically generates on line 197, a standard 
NTSC color video signal and a video black and white 
video signal on line 198 (FIG. 8). This display subsys- 
tem, in addition to other inputs, receives a synchroniza- 
tion signal, and several clocking signals. For sake of 
simplicity, the standard color reference signal of 
3.579545 MHz is shown as C3.5M. Twice this fre- 
quency and four times this frequency are shown as C7M 
and C14M, respectively. 

Before describing the details of the display subsystem 
48, a discussion of a prior art display system will be 
helpful in understanding the present display subsystem. 
In U.S. Pat. No. 4,136,359, a video display system is 
described which is implemented in a commercially 
available computer, Apple-II, sold by Apple Computer, 
Inc., of Cupertino, Calif. In this system, 4-bit digital 
words are shifted in parallel into a shift register. These 
words are then circulated in the shift register at 14 MHz 
to define a waveform having components at 3.5 MHz. 
Referring to FIG. 9, line 206, assume that the digital 
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word 0001 is placed in the shift register and circulated 
at a rate of 14 MHz. The resultant signal which has a 


component of 3.5 MHz is shown on line 206. The phase 


relationship of this component to the 3.5 MHz reference 
signal determines the color of the resultant video signal. 
This relationship is changed by changing the 4-bit word 
placed in the shift register. As explained in the above- 
referenced patent, if the signal 1000 is placed in the 
register and circulated, the resultant phase relationship 
of the 3.5 MHz component results in the color brown, 
this signal is shown on line 208. With this prior art 
technique, the luminance was determined by the DC 
component of the signals such as shown on lines 206 and 
208. 

The display subsystem 48 of FIG. 1 also uses 4-bit 
words to generate the various color signals in a manner 
somewhat similar to the above-described system. Refer- 
ring to FIG. 8, 4-bit words representative of colors (16 
possible colors) are coupled to the bus 180. (The genera- 
tion of these words shall be described in detail in con- 
junction with FIG. 7.) Instead of using a shift register 
which circulates the 4-bit work, the same result is 
achieved by using a multiplexer 205 which sequentially 
selects each of the lines of the bus 180. The signals on 
bus 180 also provide a luminance signal and a black and 
white video signal with a gray scale. 

The 4 lines of the bus 180 are coupled to multiplexer 
205; this multiplexer also receives the C7M and the 
C3.5M timing signals. These two timing signals cause 
each of the four lines to be sequentially selected and 
coupled to line 191. (Note that the order in which each 
of the lines of the bus 180 is selected does not change.) 

In effect, the multiplexer operates to serialize the 
parallel signal from bus 180. Assume for sake of expla- 
nation that the digital signals on bus 180 are 1000 as 
indicated in FIG. 8. The signal on line 191 will then be 
10001000 .... The output of the multiplexer 205 cou- 
pled to the input of the inverter 204 also receives in a 
sequential order, the signals from bus 180, however, in 
a different order. For the example shown, the input to 
inverter 204 is 00100010.... After inversion, this results 
in the signal 11011101 ... on line 192. Effectively, the 
signals on lines 191 and 192 are added by resistors 199 
and 200. The resultant waveform is an AC signal (no 
DC component) shown in FIG. 9 on line 209. Thus, 
with the described circuit, a chroma signal is generated, 
having a predetermined phase relationship to the 3.5 
MHz color reference signal. This phase relationship 
which is varied by changing the signals on bus 180 
determines the color of the video signal on line 197. 

In the prior art display discussed above, the DC com- 
ponent of the color signal determines the luminance. In 
the present invention, the signals on bus 180 are coupled 
to the base of transistor 195, consists of an AC signal 
from resistors 199 and 200, and the luminance level also 
determined by the signals on bus 180. These inputs to 
transistor 195, along with the C3.5M signal, generate a 
NTSC color signal on line 197 of improved quality 
when compared to the discussed prior art system. 

In some cases, the signals on bus 180 are all binary 
ones or all binary zeros. When this occurs, there is no 
AC component from resistors 199 and 200 (no color 
signal) and the resultant signal on line 197 is either 
“black” or “white.” 

The lines of bus 180 are also coupled through resis- 
tors to the base of a transistor 196. Each of these resis- 
tors have a different value to provide a “weighting” to 
the binary signal. 
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This weighting is used for non-color displays to pro- 
vide “gray” shades as opposed to having a display with 
only black and white. The binary signals on bus 180 
drive the transistor 196 to provide a video signal on line 
198. RGB is generated with weighted sums of these 
same five signals. 

Referring now to FIG. 7, data from memory is cou- 
pled from the A bus and B bus to registers 159 and 158, 
respectively. These registers are clocked by the 1 MHz 
clocking signal and its complement, thus permitting the 
sequential transfer of 8-bit words every 0.5 msec. As 
will be described, in some display modes the data is 
transferred at the 2 MHz rate, and in other display 
modes, at a | MHz rate. 

The registers 158 and 159 are coupled to an 8 line 
display bus 160. This display bus transfers data to regis- 
ters 164 and 173, and also addresses to a memory 162. 
The registers 164 and 173 and memory 162 are enabled 
during specific display modes as will be apparent. 

The character memory 162, in the presently preferred 
embodiment, is a random-access memory which stores 
patterns representative of alpha-numeric characters. 
Each time the computer is powered up, the character 
information is transferred from the ROM 50 into the 
character memory 162 during an initialization period. 
During character display modes, the signals from the 
display bus 160 are addresses, identifying particular 
alpha-numeric characters stored within the character 
memory 160. The vertical counter signals V4, Va, and 
Vc (previously discussed in conjunction with adder 121 
of FIG. 4) identify the particular line in each character 
which is to be displayed. Thus, the generation of the 
digital signals representative of each of the characters 
occurs in an ordinary manner. The 7-bit signal represen- 
tative of each line of each character (memory output) is 
coupled to the shift register 167. Through timing signals 
not shown, either the register 164 or the character mem- 
ory 162 is selected to allow the shift register 167 to 
receive either data directly from the A bus or B bus, or 
alpha-numeric character information from the memory 
162. 

The 7-bits of information from either memory 162 or 
register 164 are serialized by the shift register 167 either 
at a 7 MHz rate or 14 MHz rate, depending upon the 
display mode. The serialized data is coupled by line 185 
to the multiplexer 169, pins 1 and 4. The inverse of this 
data is also coupled to multiplexer 169, pin 3. Line 185 
is also coupled as one input to the multiplexer 166 and to 
the register 170 (input 1). 

The output 1 of register 170 (line 186) is coupled to 
the multiplexer 169, pin 1; to register 170 (input 2); and 
to multiplexer 166. Output 2 of register 170 (line 187) is 
coupled to input 3 of register 170 and also to multiplexer 
166. Output 3 of register 170 (line 187) provides a third 
input to the multiplexer 166. Input 4 of the register 170 
receives the output of the multiplexer 169 (line 189). 
Output 4 of register 120 (line 190) provides one control 
signal for the multiplexer 171. 

The multiplexer 171 selects either the four lines of bus 
183 or the four lines of bus 184. The output of multi- 
plexer 171, bus 180, provides the 4-bit signal discussed 
in conjunction with FIG. 8. During one of the high 
resolution display modes (AHIRES), the multiplexer 
171 is controlled by a timing signal from the output of 
the gate 178. 

The multiplexer 166 selects either the lines of bus 181 
or bus 182. The output of this multiplexer provides the 
signals for the bus 184. In all but the AHIRES display 
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mode, multiplexer 166 selects bus 181. Thus, typically, 
the multiplexer 171 receives the signals from bus 174. 

For purposes of description above, and also for pur- 
poses of explaining for some of the display modes below 
a simplifying assumption has been made. The signals 
coupled to the bus 180 by multiplexer 171, for most 
modes, are controlled by the serialized signal on line 
190. This serialized signal is in sychronization with the 
CT7M or C14M clocking signals. The multiplexer 205 of 
FIG. 8, which as described above, does the “spinning” 
for the parallel digital signal on bus 180, operates in 
sychronization with the multiplexer 171. In the descrip- 
tion above, and except when otherwise noted below, it 
is assumed that, by way of example, if the multiplexer 
171 is coupling all binary ones and zeros onto bus 180, 
the signal on line 191 will be either ones or zeros. Also 
for this condition the signal on line 192 will be all binary 
zeros or ones, and thus, no AC signal is generated at the 
base of transistor 195. However, as actually imple- 
mented, there is a “phase” difference between the 
clocking of the multiplexer 171 when compared to the 
sampling of the signals from bus 180 by the multiplexer 
205. This results in a first constant AC signal on the gate 
of transistor 195 even when it appears that all binary 
ones are on bus 180, and a second constant AC signal 
when all binary zeros are on the bus 180. Thus, in this 
specification, when it states that “black” or ‘‘white” 
signals are being generated, instead, as currently imple- 
mented, two constant colors are generated on a color 
display. Where a true black and white is desired, color 
suppression is introduced such as through the color 
burst signal. 

The circuit of FIG. 7, along with the circuit of FIG. 
8, provides the capability for several distinct display 
modes. The first of these modes provides a display con- 
sisting of 40 characters (or spaces) per horizontal line. 
This requires a data rate of 8-bits/MHz or half the data 
rate the memory is capable of delivering. In this mode, 
data is loaded from the A bus during every other 0.5 
psec period. (B bus is not used during this mode.) This 
data addresses the character memory 162, and along 
with the signals V4, Vgand Vc, provides the appropri- 
ate character line (7-bits) to the shift register 167. Dur- 
ing this mode, registers 164 and 173 are disabled. The 
shift register 167 for this mode shifts the data at a data 
rate of 7 MHz (note CH80 is high, allowing the 7 MHz 
signal from gate 175 to control the shift register 167). 
Each 7-bit signal is shifted serially onto line 185 and 
then to line 189 since multiplexer 169 selects pin 4. The 
data is shifted through the register 170 onto line 190. 
The serial binary signal on line 190 causes the selection 
of buses 183 or 184. 

The four lines of bus 183 during this mode are cou- 
pled to +V (register 173 is disabled); therefore the 
selection of bus 184 provides four binary ones. The 
selection of bus 184 provides four binary zeros through 
bus 181. Thus, the serial binary signal on line 190 pro- 
vides either all binary ones or all binary zeros to bus 
180. As discussed, the circuit of FIG. 8 will provide a 
black and white display with 40 characters per line. 

If the inverse and flashing timing means 172 is se- 
lected, each time the shift register 167 is loaded, multi- 
plexer 169 shifts between pins 3 and 4. This causes the 
characters to change from white characters on a black 
background to black characters on a white background, 
and so on. 

During the 80 character per line display mode, the 
registers 158 and 159 are each loaded during sequential 
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0.5 psec periods (this utilizes the 2 MHz cycle rate 
previously discussed). The shift register 167 shifts the 
character data from memory 162 at a 14 MHz rate. The 
serialized data at the 14 MHz rate is shifted through the 
register 170 and again controls the multiplexer 171 as 
previously described. (Note that register 170 is always 
clocked at the 14 MHz rate.) Flashing again can be 
obtained as previously discussed. 

In another alpha-numeric character display mode, the 
background of each character may be in one color and 
the character itself (foreground) in another color. This 
mode provides 40 characters per line. The character 
identification (address for RAM 162), is furnished on 
the A bus to register 159 at a frequency of 1 MHz. The 
color information (background color and foreground 
color) is furnished on the B bus as two 4-bit words to 
register 158. In the manner previously described, the 
address from register 159 selects the appropriate char- 
acter from memory 162 and provides this information to 
shift register 167. The color information from the B bus 
is transferred to register 173. For purposes of explana- 
tion, assume that the 4-bits identifying the color red for 
the background are on bus 184 (from register 173 and 
multiplexer 166) and that 4-bits representing the color 
blue for the foreground are on bus 183. (Note that when 
register 173 is enabled, the signals from the register 
override the binary ones and zeros which otherwise 
appear on the lines of bus 174.) The serial binary signal 
representative of the character itself on line 190, selects 
either the color blue from bus 183 for the character 
itself or the color red from bus 184 for the background. 
The digital signals representative of these colors are 
transferred to bus 180 and provide the color data to the 
circuit of FIG. 8. For black and white displays, a 
“gray” scale is provided through the weighting circuit 
associated with transistor 196 of FIG. 8. Again, the 
multiplexer 169 may, through the timing means 172, 
alternate between the signal of line 185 and its inverse, 
which will have the effect of interchanging the fore- 
ground and background colors. 

During the high resolution graphics modes, the char- 
acter memory 162 is not used, but rather, data from the 
memory directly provides pattern information for dis- 
play. This requires more mapping of data from within 
the main memory since new data is required for each 
line of the display. (Note that when characters are dis- 
played, the character memory 162 provides the differ- 
ent signals required for the 8 lines of each character 
row.) During these high resolution modes, the register 
164 is enabled and the character memory 162 is dis- 
abled. Thus, the data from the A bus and B bus is shifted 
into the shift register 167. In these modes, the “HRES” 
signal to multiplexer 169 causes this multiplexer to se- 
lect between pins 1 and 2. Pin 2 provides the signal 
directly from the shift register 167 while the signal on 
pin 1 is effectively the signal on line 185 delayed by one 
period of the C14M signal. This delay occurs through 
the register 170 from input 2 to output 2 since register 
170 is clocked at C14M. 
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During a first graphics mode, data from the display 
bus 160 is loaded into shift register 167 at the rate of 
7-bits/MHz. The data is serialized on line 185 and in the 
manner previously described for displaying characters, 
controls the selection of all binary ones and all binary 
zeros through the multiplexer 171. Note, as mentioned 
before, in the presently preferred embodiment, unless 
color suppression is used, this will not result in a black 
and white display, but rather a two-color display. If a 
high bit is present on line 140 of the display bus, the 
inverse and flashing timing means 172 causes the multi- 
plexer 169 to alternate between pins 1 and 2. This 
switching occurs at a | MHz rate and provides a phase 
shift for every other 7-bits of data coupled to the multi- 
plexer 171 on line 190. This results in an additional color 
being generated on the display for every other 7-bits of 
data. 

For the above-described graphics modes when shift 
register 161 is shifting at a 7 MHz rate, 8-bits may be 
coupled to the bus 160 during each period. Specifically, 
as in the case of the differing background and fore- 
ground colors for the 40 character per line display 
mode, two 4-bit color words are shifted into register 173 
at a rate of 1 MHz. Then, the multiplexer 171 selects 
between two predetermined colors on buses 183 and 
184. Note these colors can be changed at a 1 MHz rate. 


In an additional color mode identified as “AHIRES,” 
multiplexer 171 operates under the control of gates 176, 
177 and 178. In effect, multiplexer 171 selects bus 184 
and latches the signals on this bus every four cycles of 
the C14M clock. Data is shifted into the shift register 
167 from the A bus and B bus every 0.5 y sec the regis- 
ter 167 operates under the control of the C14M signal. 
Each data bit on line 185 is shifted first to line 186, then 
to line 187 and finally to line 188. These lines are cou- 
pled to the multiplexer 171 through multiplexer 166 
which selects bus 182 since AHIRES is high. In effect, 
what occurs is that 4-bit color words are serialized onto 
line 185 and then brought back into parallel on bus 182. 
Since multiplexer 171 latches the signals on bus 184 
every four cycles of the C14M signal, a new color word 
is generated at a 3.5 MHz rate on the bus 180. The 
resultant display is 140 by 192 colored blocks wherein 
each block can be any one of 16 colors. 


In the last display mode, typically used with color 
suppression, data is shifted into the shift register 167 
from the display bus at the rate of 14-bits/MHz. The 
data is serialized onto line 185 and controls the selection 
of either all binary ones or all zeros through multiplexer 
171. This provides the highest resolution graphics dis- 
play for the system. 

Thus, a microcomputer with video display capability 
has been described. The computer is fabricated from 
commercially available parts and provides high utiliza- 
tion of these parts. Numerous existing programs includ- 
ing many of those which operate on the Apple-II com- 
puter, may be employed in the above-described com- 
puter. 
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FOOO. 1D 4404058000849 8 SON SESHOSC EEE 
FOOO a 14 * CRITICAL TIMING | 
FOOO 1S * REQUIRES PAGE BOUND 
FOuGd 16 *# CONSTDERATIONS FOR 
FOOO and CODE AND DATA 
FOGO 18 * 
FO0O 19 + VIRTUALLY THE ENTIRE 
FOOO ao * ‘WRITE’ ROUTINE 
FOCQ ol 4 MUS! NOT CROSS 
FOG ea * PAGE BOUNRDARTES 
FOOO 2S * CR. i2.. BRANCHES IN 
FOOO 24 * THE ‘WRITE’, ‘READ’, 
FOOO 25 * AND FEAD ADR’ SUBRS 
FOcO 26 # WHICH MUST NOT CROSS 
FOOO ea” 4+ PAGE BOUNDAR TCS ARE 
FOOO 28 * NOTED IN COMMENTS 
FOOO ao 
FOOCG CMrrrTrTrTrT TTT TTT TTT TTT TTT TTT Tt 
FOoo 31 # * 
FOOO. Qe +# EQUATES * 
FOOO 33 # * 
0200 34 NBUF 1 EQU $206 
03902 35 NBUF2 EQU) $302 i (ZERO PAGE AT $3003 
FQOO 36 # 
ooso: 37 HRDERRS EQU $80 
OVEO. 38 DVMOT EQU $E0 
FOGG GP et 
OG1 49 IGSLOT EQU £81 
o082 41 TBrRYN EQU IBSLOT+1 
0083 42 IBTRK EQU IBSLOT+2 
0084: 43 IBSECT EQU IBSLOT+¢3 
90e5 44 IDBUFP EQU IBSLOT+4 
O08 -. 435 IBCMD Eau IBSLOT+6 
oo8A 40 IBSTAT EU IBSLOT+7 
0089 47 IBSMNCD EQu IBSLOT+S 
o0a9 48 CSUM EGU IBSMOD i USED ALSO FOR ADDRESS HEADER CKSUM 
OOBA 49 TOBPDN EQU IBSLOT+9 
0038B So IMASK EQU IBSLOT+$A 
ooRrr Si CURTRK ou IBSLOT+$RB 
CO28 Se DRVOTRK FGU CURTRK-7 
FOOU 532 : SLOT “RIVE 1 
FOOO 54 , SLOT CRIVE 2 
FOOO: 55 . SLOT DRIVE 4 
FOOO 56 ; SLOT DRIVE 2 
FOOG 57 ,St.0T DRIVE 1 
FOOO 58°; SLOT DRIVE 2 
O0F3 S? RETRYCNT EGU IBSLOT+$ic¢ 
0094 60 SEEKCNT EQU IBSLOT+$13 
0098: 61 BUF EQU IBSLOT+$1A 
62 ENVTEMP EGU IBSLOT+$1E 
63 *IBSLOT+$1F NOT USED 
64 # 
SE £984 854-004 29508000008 608 
YA 
68 * —---READADR---- * 
69 # * 
TO RHEE REESE EEE EER 
71 COUNT EQU IBSLOT+$14 ; ‘MUST FIND’ COUNT. 
7a LAST EQU IBSLOT+$14 ; ‘ODD BIT’ NIBLS. 
73 CKSUM _EQU 
74 CSSTV EQU IBSLOT+$16 ; FOUR BYTES, 
73 * CHECKSUM, SECTOR, TRACK, AND VOLUME. 


eee eR KE HR HR RH He YK 


APPLE 1 BOCT ROM LISTING 
REVISION I ROM Coe adele £189) 


TT RR RRERE EEE EEE NEE EEE EE 
78 * * 
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79 * aan WRITES" = 
80 * 
Bil # USES ALL NBUFS 
_ 82 *  __AND 32-BYTE 
83 * DATA TABLE ‘NIBL’ 
84 * 
[= }) HRRKRERE EEE EE EEE EERE EH 
86 * 
QF RHHKHHREREEEEE ERE EREEE 


i 
t 


kkk wk HIE 


* 


READ---- | 


1 
4 
1 
| 


USES ALL NBUFS 
USES LAST 54 BYTES 
OF A CODE PAGE FOR 
SIGNIFICANT BYTES. 
OF DNIBL TABLE. 


' 


eek eK KH 


D7 EERE EEE EEE EEE EEE 
98 * 
99 Peer e ee Tr rTP e rr eT ee rh oo 
100 * : * 
101 * ---- SEEK ---- * 
102 * * 
103 RRR HKEEREN 7 
104 TRKCNT EQU COUNT ;HALFTRKS MOVED COUNT 
105 PRIOR EQU IBSLOT+S$1C 
106 TRKN EQU IBSLOT+$1D 
107 * 
LOB HH EE Ee EE 
109 * * 
110 # ---- MSWAIT ---- * 
iil * # 
tie Mee He Fe EEE IE EEE 
113 MONTIMEL EQU CSSTV+2 i MOTOR-ON TIME 
114 MONTIMEH EQU MONTIMEL+!1 ; COUNTERS 
115 * ; 
L1L7 SOOOOO S00 S OS 2 H6OS COTE TES 
1168 # Sete, 
119 DEVICE ADDRESS * 
120 * ASSIGNMENTS * 
5S) a eae ee * 
L2Q2 HREM EEE EEE EEE EEE 
123 PHASEOFF EQU $CO80 ; STEPPER PHASE OFF. 
124 PHASEON EQU $COB1 | 
125 @é6L $cOoBc ; Q7L. Q6L=READ 
126 Q6H $coeD ; Q@7L, Q6H=SENSE 
_127 Q7t. __ EGU $COBE _. (Q@7H, G@6L=WRITE 
12€ Q7H $COSF ; Q7H, QGH=WRITE 
129 INTERUPT EQU SFFEF 
130 ENVIRON EQU SFFDF —... _ 
131 ONEMEG EQU #80 
132 TWOMEG EQU $%7F 
LGD HARARE EEE HERAT THREE EERE 
134 * 
135 * EQUATES FOR RWTS AND BLOCK 
136 * =* ite) xe 8S a . 
137 rere re ee ere rr Perr ore re Tt te 
138 MOTOROFF FQuU $CO08s 
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C089: 139 MOTORON EQU _ 
COBA: 140 DRYOEN EQU 
COSB: 141 DRVIEN EQU 
CO8i: = 142 PHASON EGU 
cOs8o: 143 PHSOFF EQU 
O097 144 TEMP EQu i; PUT ADDRESS INFO HERE 
0097 145 CSUM1 EQU 
0098. 146 SECT EQU CSUM1i+1 
0099" 147 TRACK EQU SECT+1 
0099. 148 TRKNi EGU TRACK 
OPA: 149 VOLUME EQU TRACK+1 
JOBS 150 IBRERR EQU HRPDERRS-+3 
Wee {BDERR EQU) HARDERRS+2 
Oost IBWPER EQU HRDERRS+1 
0080: IBNODRV EGU HRDERRS 
Fooo Na S| 
FOOO: | : . _. * 


FOOO * “Cal WRITE A * 

FOOO * itxCw AND SECTOR + 

£906 “ z 

FOOO Wee ee ee ee eee ee SS eS 

FoOuo + 

FOQOO AC REGRWTS IDY #1 jRETRY COUNT 

POG 14.3 Lbx  1BSLOT /GET SLOT # FOR THIS OPERATION 
ro04 & 4 i Sty SEEKCNT -UNLY ONE RECALIPRATE PER Aut. 
FO06 O08 = ala » DETERMINE INTERUR YT STATUS 
FOO7 PLA 
FOo8. ; ROX 
FOO9: ROR 
toa Lay ROR 
FOOL ¢é ro ROP 4 

FOOC B84 : TA LMASK 

FOOE Te LDA ENVIRON i PRESERVE ENVIRONMENT 

FOltL 3 STA ENVTEMP 

FO13 * : 

FO1g 7S ¢ NOW CHE O- LF THE MmoTOR IG ON. THEN START IT 

FOL ia # 

Papo 20 2 _ a ISP WHE DRY TET ZERO FLAG IF MOTOR STOPPEL 

1O16 » SAVE TEST RESULTS 

FOL? &S$ , y IBBUFP iMOVE OUT POINTER TO BUFFER INTO 7F 456 
FOV? B95 BUF 

FOLB ° 1 {BEUFP+! 

FOLD C She 374 RUF +t 

Po.k VE Ye 3 Lor aDVMOT 

FO?) gf MONT IMEH 

FO23 : IBDRYN ; DETERMINE DRIVE ONE OR TWO 

FOeRS TOBP DN 1SAME DRIVE USEI! GEFORE 

FORT 35 9 Fo Ste  TUSPDN Gel IT FOR NEYT TIME 

Fon? 9 wht be EP RESULTS (IF COMPARE 

Fess c 2 "oh a ok? DRIVE NUMMER friTfi3 CARRY 

Fo2b PN my c ; MOTORGN, K «TURN ON THE DRIVE 

FOO VC , DRIVSEL i BRANCH IF DRIVE 1 SELECTED 

FOGG Et s >SELECT DRIVE 2 

en] fe slug W3 LRIVSEL & DRVOEN, x 

Fw Ba = 7 3 SETIMEG is INSURE GONE MEGAHERTZ OPERASTION 

FOU? 2a . »WAS iT SANE DRIVE 

FO38° : OK 

FO3A jMUST INDICATE DRIVE OFF BY SETTING ZERO 
FO3B 47 i DELAY 150 MS BEFORE STEPPING FLAG) 
Fem3p oe SF 199 DRVWAIT . MSWAIT » CON RETURN Aries 

O04 

POSt C2 20 INE = =6DRVWAIT 

FO43: ;NOW ZERO FLAG SET 

FO4d: 2 IBTRK + GET DESTINATION TRACK 

FO46 ain : 1BSLOT ij RESTORE PROPER <¢ (SLOT#1é) 

FOOSE at O5 o MYSEEK i AND GO TO IT 

FOaB 204 #NOW AT THE DESIRED YTRACK WAS THE MOTOR 

FolaR Oo? 2 IN TO Sf4PT WITH? 

FO4B 2¢ PLP +WAS MOTOR ON? 

FOC 34 BNE TRYTRK ,IF SO. DON’T DELAY, GET IT TODAY! 

FOE. 


Co OCCSCSCSCSCSCCCC*S Paige 0027 OF OTTO 
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FOaE OL, # MOTOR WAS OFF, WAIT FOR 1T TO SPEED UP 
FO4E. ele + 
FO4E: 213 MOTOF LDY #$12 ); WAIT EXACTLY 100 US FOR EACH COUNT 
FOQOSO: 214 CONWAIT DEY ! > 
"O51 a te Ne CONWALT IN MONTIME 
rGos Ex +9 “ INc MONTIMEL «COUNT UP TO 0000 
Rises Na pe BNE MOTOF 
Bi toe - ei INC MONT IMEH 
rOO9 . 3 aft BNE MOTOF 
FOSB: errr rr rrr Terr rrr rT ttt ted 
FOSBD: fea * ; 
FOSB 23 * MOTOR SHOULD BE UP TO SPEED 
FOSR 204 2 TF IT STILL LOOKS STOPPED THEN 
FO5B 38 oe Sr DRIVE TS NOT PRESENT 
FOSB + 
FOSB ies ererrrrr rr rr rrr rrr rrr ret. tok A 
FOSB. 1 = JSR CHADRYV ;1S DRIVE PRESENT: 
FOOSE ie BENE TRY FRK » YES, CONTINUE 

lw HK OVERPR GLA a DBNODRY Jo, GET TELL EM NO DR UR 

JMP  HNDLERR 


a 7 
+ MOW CHECK {fF IT IS NOT THE FORMAT DISK COMMAND 
» LOCATE [THE CORRECT SECTOR FOR THIS DPERAT ION 
& 
Tr Th LDA TRCMD ,OET COMMAND CODE # 
PEG  ALLIDOME [TP RULL COMMAND, GO HOME i: BED 
CMP #3 ; COMMAND IN RANGE” 
BCS ALLDONE iNQ, DQ NOTHING! 
ROP a : .SET CARRY=1 FOR READ FR WRITE 
KOS TRYTRKS SMUST PRENTEBL ITE fue wk ITE 
Loa ENVEROS 
ALELs #7 WOME / SHIFT TO HIGH SPEED' 
STA ENVIRON 
JER PRENIBIio 
LOY #EVF ONLY 127 RETRIES OF ANY KIND 
Bo Pr Nyy 
.¢ Pe LOY ,GEt SLOT NUM INTO X-REG 
7, PRLS ,REAL WEXY ADPRESS FIFLE 
po’ PDRIGHT <+IF READ TT RIGHT, HURRAH! 
revADR. BIT [MASA ;SHOULD INTERUPTS DE AI.LOWED™ 
BMt NOQINTR1 ;NOQ. DON’T ALLOW THEM 
mh + RE-ENABLED AFTER READ/READADR ‘WRIT’ 
cee FEETRYCNT ANOTHER MISTAEX'! FAILURE 
nf.  TRYADR ; WELL, LET IT SO THIS TIME 
LDA CURTRK 
PHA ; GAVE TRACK WE REALLY WANT 
DEC SEEKCNT ;ONLY RECALIBRATE ONCE! 
ie BNE DRVERR ; TRIED TO RECALIBRATE A SECOMD TIME: — 
oe LDA #$60 /RECALIDRATE ALL OVER AGAIN! ERROR! 
ae! JSR SETTRK ; PRETEND TO BE ON TRACK 80 
2be LDA #800 
26% JSR MYSEEK i MOVE TO TRACK OO 
264 Gall PLA 
Gh tet BL SR MYSEEK GO TU CORRECT TRACK THIS TIME! 
Brory “mp TRYTRKZ + LOOP BACK, TRY AGAIN ON THIS TRACK 
een * 
“2.8 4% HAVE NOW “EAD AN ADDRESS FIELD CORRECTLY 
269 + MAKE SURE THIS IS THE TRACK, SECTOR, AND VOLUME DESIRED 
2vVO ROPIGH! LDY TRACK ,ON THE RIGHT TRACK? 
aot (By “URTRK 
ave RE) TRA ;1F SG, GOGD 
QQ oe KEW LPR PNG FROM THIS TRACK 
274 CURTRK ; PRESERVE DESTINATION TRACK 
275 
276 
25 Fi 277 SETTRK 
. 68 278 
Foes: 20 OS Fl 279 MYSREK 


_FOm8: 4C 86 FO 280_ JMR TRYADR2 1 GO AHEAD AND RECALIBRATE 
FORR. 262 + 

FOBB: | 283 * DRIVE 1S ON RIGHT TRACK, CHECK VOLUME MISMATCH 

FOSB 264 * 

FOBB AS 9A DAS RTTRK LDA VOLUME LGET ACTUAL VOLUME HERE 

FORD 85 99 286 STA IBSMOD [TELL OPSYS WHAT VOLUME Wad THERE 
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FOBF: CORRECTVOL LDA SECT i CHECK 1F THIS IS THE RIGHT SECTOR 
FOCl. ‘ CMP IBSECT 
FOC3. BEQ CORRECTSECT :1F SO. DO WHATEVER WANTED 
FOCS D 2 BNE TRYADR2 »NO. TRY ANOTHER SECTOR 
FOCY AS _ CORRECTSECT LDA IBCMD »READ OR WRITE” 
LOC9 296 LGR A : THE CARRY WILL TELL 
FOCA BCC WRIT i CARRY WAS SET FOR READ OPERATION, 
FOCC 2 JSR READI6 i CLEARED FOR WRITE 
FOCE BCS TRYADR2 i CARRY SET UPON RETURN IF BAD READ 
POPL A r 5 LD&A ENVIRON 
PODS a ; : AND #TWOMEG 
PO04 SL fs STA ENVIRON »SET TWO MEGAHERT? MODE 
rOD9 é = JSR POSTNIB16 ; DO PARTIAL POSTNIBBLE CONVERSION 
FoDC BCS TRYADR2 i CHEKSUM ERROR 
FODE < LDX IBSLOT i RESTORE SLOTNUM INTO x 
FEO 39e ALL DONE Cur 
PORT LDA #€€0 / NO ERROR 
FOE A § 2 i BCC ALDONEL »SKIP OVER NEXT BYTE WITH PT? OPCODE 
FOES DRVERR PLA +; REMOVE CURTRK 
FOERS6 30é LDA #IBDERR i BAD DRIVE 
FOES . HNDLERR SEC i INDICATE AN ERROR 
FOR? SS a6 wee ALTONEL STA IBSTAT i GIVE HIM ERROR# 
= OFB f = LDA MOTOROFF, « i; TURN IT OFF 
frQNeG ssa 4 re bIiT 1MASK ;SHIULD INTERUPTS BE ENABLED” 
FORFG O , BM] NOINTR2 i) BRANCH IF NOT 
FOFS. % cil 
FOF? ) z NOINTR2 LDA ENVTEMP i RESTORE ORIGINAL ENVIRONMENT 
Fors Sb Dr OF 3 STA ENVIRON 
: RTS 
JSR We lTELG »WRITE NYBBLES NOW 
BCC ALLDONE i IF NO ERRORS 
LDA #IBWPER i DISK IS WRITE PROTECTED! ' 
BYC HNDLERR i TAKEM IF TRULY WRITE PROTECT ERROR 
MP TRYADRe is OTHERWISE ASSUME AN [NTERUPT MESSED 
THINGS UP 


ieTco 15 THE ‘SEEK’ ROUTINE 

SEEKS TRACK ‘N’ IN SLOT #xX/$10 
IF DRIVNO 15 NEGATIVE, ON DRIVE O 
IF DRIVNO [S POSITIVE, ON DRIVE 1 


2 
3 
4 
re 
a) 
we 
rr 


At 
Va ed Mi he 


fd 
Soe ak Ghose 3 
Pa a or ae 


“ 


MYTEEK ASL OA / ASSUME TWO PHASE STEPPER 
GEre t STA TRAN . SAVE DESTINATION TRACK( #2) 
JSR ALLOFF ; TURN ALL PHASES OFF TO BE SURE 
JSR DRVINDX ;GET INDEX TO PREVIOUS TRACK FOR CURRENT 
LDA DRVOTRK, « DRIVE 
STA CURTRK / THIS [S WHERE T AM 
LDA TREN } AND WHERE I’M GOING TO 
STA DRVOTRE. x 
GOSFEA JSR SEEK iGO THERE! 
ALLOFF LDY #3 ; TURN GFF ALL PHASES BEFORE RETURNING 
NXOFF = -TYA 7 + (SEND PHASE IN ACC. ) 
Fa: JSR CLRPHASE. ; CARRY IS CLEAR. PHASES SHOLD BE TURNED 
DEY OFF 
BPL | =NNOFF : 
Fl22:46 @C 341 + &#;|L@R CURTRK  ;iDIVIBE BACK DOW 
F124 460 RTS ij; ALL OFF... NOW IT’S DARK 
Fi2s: 
F125:  _ 345 * THIS SUBROUTINE SETS THE SLOT DEPENDENT TRACK | 
Files: 346 # LOCATION 
Files 347 & 
Fi25 20 BE F1 348 SETTRK JSR DRVINOX | 
F128:95 85 349 STA DRVOTRK. X 
Flea: 60 350 RTS 
FI2B: BSL PARE E EERE EEE 
FieB 352 * 
FLeB: 353 * SUEUR TO TELL IF MOTOR IS STOPPED 
F12ep 354 * oe ee et 
F12B- 355 #* IF MOTOR IS STOPPED. CONTROLLER ’S 
F12B: 356 * SHIFT REG WILL NOT BE CHANGING. 
F12B 357 * 


F12H 358 * RETURN Y=O AND ZERO FLAG SET IF IT IS STOPPED 
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# 
He Fe EE EE aE EEE EE EE EH EE 
61 CHKDRV. LDY #0 i; INIT LOOP COUNTER 
CHADRV1 LDA GéL. X ; READ THE SHIFT REG 
JSR CKDRTS i DELAY ie 
PHA 
PLA >MORE DELAY 
CMP GSL, X iHAS SHIFT REG CHANGED™ 
BNE CKDRTS ; YES, MOTOR IS MOVING 
DEY ;NO, DEC RETRY COUNTER 
2 BNE CHKDRV1 i; AND TRY 256 TIMES 
CKBRTS RTS i THEN RETURN 
% 
DRYINDX PHA ; PRESERVE ACC 
TXA ;GET SLOT(*$10)/8 
LSR A 
LSR A 
LSR A 
ORA IBDRYVN ; FOR DRIVE O OR 1 
TAX ; INTO X FOR [INDEX TO TABLE 
PLA ; RESTORE ACC 
RTS 
PrEre rrr rere rT eT re ST PPT ETT 2 
# 
e NOTE: FORMATTING ROUTINES 
* NOT INCLUDED FOR SOS 
+ 
MRE KEE HEE 


READ SUBROUTINE 
(16-SECTOR FORMAT) * 
* 
PST Serre rrr rrr TTT TrTTT Tt, 


READS ENCODED BYTES 
INTO NBUF1 AND NBUF2 


oe 


FIRST READS NBUF2 
HIGH TO LOW, 

THEN READS NBUF1 
LOW TO HIGH. 


---- ON ENTRY --— 


X-REG: SLOTNUM 
TIMES $10. 


Re KIKI KK KK K 


READ MODE (Q@é6L, Q7L) 


--~- ON EXIT 


CARRY SET IF ERROR. 


SESE EEE EERE ER HE 


! 
1 


IF NO ERROR: 

A-REG HOLDS $AA. 
X-REG UNCHANGED. 
Y-REG HOLDS $00. 
CARRY CLEAR. 

_.. 77m _CAUT ION 


| 


xe e KK Kt 
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F14e@: 421 * OBSERVE 
F148: 422% ‘NO PAGE CROSS’ 
F148: 423 * WARNINGS ON 
F14e8: 424 « SOME BRANCHES! ! 
F148: — 425 * ao. heen ee 
F146: 426 * —--- ASSUMES ---- 
F148: 427 * 


F148 428 * 1 USEC CYCLE TIME 


+8 


eix © eK KK 


F148: = 429 % 
F1i4e: QO he 

F148.40 20 431 READIG LDY #20 

i 1,aA B8 432 RSYNC DEY  ~ 

r184B FO 6B 433 BEG RDERR ; THEN EXIT WITH CARRY SET 
FI4) BD 8C CO 434 RD1 LDA Q@é6L, X_ i; READ NIBL. _ Z 
Fi30:10 FD 435 BPL RDI ;*#*% NO PAGE CROSS! ### 
F152.49 DS 436 RSYNC1 EOR #$D5 ;DATA MARK 17 

F154:D0 F4 —— 437 __BNE RSYNC_ ;LOOP IF NOT. | fee 
FL5S6 EA 438 NOP ; DELAY BETWEEN NIBLS 
F157 BD 8C CO 439 RD2 LDA Q6L, xX 

£1i5A 10 FB 440 BPL RD2 ;### NO PAGE CROSS! *#* 
F1SC°C9 AA 441 CMP #8AA i DATA MARK 27 

F1S5SE:DO F2 442 BNE RSYNC1 i (IF NOT, IS IT DMi?) 
F160: A0 $5 443 _LDY #6355 i INIT NBUF2 INDEX. 


Flé2 444Q # (ADDED NIBL DELAY} 
Fi6ée BD BC CO 445 RD3 LDA G@éL. X 
F16S 10 FB 446 BPL RDS | ##% NO PAGE CROSS! ##* 
AD 447 _ CMP @8aD i DATA MARK 37 
E7 44 BNE RSYNC1 > CIF NOT. 1S IT DMI) 
449 (CARRY SET IF DM3') 
450 LDA Gol, xX 
451 BPL RD4 | #ae NO PAGE CRUSS! ##* 
452 STA NBUF2, ¥ . STORE BYTES DIRECTI.Y 
453 LDA INTERUPT <POLL INTERUPT LINE 
a4 BRA TMASK  OTHIS MAY BE USED bl ithvar TD4STE FOL 
455 BPL GOSERV 
ASE DEY . INDEX TO NEXT 
So7 BPtL. RD4 
458 . (FIRST TIME Y=) 
459 GL. x GET ENCODED BYTES OF NBLF1L 
G6) RDA 
461 NBUF LY 
aor De INTERUPT POLL INTERUPT LINE 
463 1Mask _ (THIS MAY BE USED TO INVALIDATE POLL: 
464 GOSERV 
445 #$E4 WITHIN 1 MS OF COMPLETION™ 
+66 RDS 
G4? 
468 Bead Gai. xX NO POLL FROM NOW ON 
469 RDO 
470 NBUF 1, 'f 
471 ; FINISH OUT NBUF1 PAGE 
We iE RDS 
373 ROOKSUM : oL. Xx ,GET CHECKSUM HYTE 
474 . RbBCKSUM 
473 CKSUM 
476 i; EXTRA DELAY BETWEEN BYTES 
477 QoL, X 
A778 : ROT ,##e NO PAGE CROSS! *#* 
FLAY = 409 : #EDE FIRST BIT SLIP MARK” 
FLAC DG 440 > RDERR _cERR IF NOT) 
FIAE E 481 ,DELAY BETWEEN NIBLS 
FLAF > 482 QOL, x 
F1Be 482 RDS ;+##s NO PAGE CROSS’ *«#+* 
r1B4 ¢ ae 2 #E44 ; SECOND BIT SLIP MARK™ 
FLIBS FO) 5 385 PDEXIT . (DONE IF IT 18) 
FLn@ 3s ado RDERR ac -{NDICATE ‘ERROR EXIT’ 
FIBS: 47 : | RETURN FROM READI6é OR RDADRIS 
FIBA 488 * 
FIBA : ey GOSERV SERVICE ,GO SERVICE INTERUPT 


% — oO 
vi — AD 


REV 


ADDRESS F/BG SPEC HES 
REVUION : 
KE 


KOM 


CO OOOSCSCSCSCSCSCSCSCSSCCSCTC*S Pg 005 F017 
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BD 1 a ee 
* 


* READ ADDRESS FIELD * 
* SUBROUTINE * 
* (14°-SEC TGR FORMAT) + 
# 

Peer ec eee eS te ee 


READS VOLUME. TRACK 
AND SECTOR 


~--- ON ENTRY ---~ 
XREG: SLOTNUM TIMES 
READ MONE Cael. @?L 


---- ON EXIT ----~ 


x eee Ok Ok x eK KK 


CARRY SET [F ERROR 


sep eee ey KH KK KH H 


TF NO ERROR 
A-REG HOLDS Boe 
Y-REG HOLDS #00. 
X-REG UNCHANGED 
CARRY CLEAR 


ee a 


¥ 


CSSTV HOLDS CHKSUM, 
SECTOR. TRACK. AND 
VOLUME READ. 


USES TEMPS COUNT, 
LAST, CSUM. AND 
4 BYTES AT CSTV 


---- EXPECTS --~- 


ORIGINAL 10-SECTOR 
NORMAL DENSITY NIBLS 
(4-BiT), ODE BITS. 

THEN EVEN 


~=-- CAUTION ---~ 
OBST RCE 
‘NO PAGE chons: 
WARNINGS ON 
SOME BRANCHES! ! 


---- ASSUMES ---~ 


ke kk RAD RK ee Ee OK RR OR KR 


1 USEC CYCLE TItil 


* 

+ 
+ 
+ 
% 
+ 
& 
% 
*% 
* 
+ 

ce 
4 
e 
tt 
* 
* 
R 

+ 
* 
* 
* 
wz 
a 

* 
% 
+ 
* 
ad 
* 
+ 


* 
FABD: 5 TET TTC oro Cf ocr rrrr re Pere) 
Fi8D: AO FC 9 RDADR16 LDY #&FC 
FiBF: 84 95 STY COUNT i ‘MUST FIND’ COUNT. 


CSSSSCCCC*S Pag 0026 OTT 
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35 36 
F1ic1.C8 547 RDASYN = INY 
F1ic2 DO 04 BNE 


PDA! »LOW ORDER OF COUNT 


F1C4 £6 
Fice FG 
“ye BD 
RICB es 

On oF 
RICK pe 


INC COUNT 
BEQ@ RDERR 
RDAI LDA QéL, x 
SPL RDAI 
RU4ASNi CAP #819 
BNE RDASYN 


i (2K NIBLS TO FIND 
» ADR MARK, ELSE ERR) 
» READ NIBL. 
tet NO PAGE CROSS! rae 
OD MARK 17 
i (LOOP IF NOT) 


Pip. EA NOP 
toe BD o RDA LDA 
Enitee TH) 1% DRL =RDAQ peer HO PAGE CROSE' ree 
iyo 6s oo COMP  #$AA -ADP MARK 27 

: : BRE RDASN: » CF NOT, 18 IT Att: 
LDY $3 ) INDEX FOR 4-BYTE FEAT 
(ADDED NIBL DELAY?) 
1DA QoL. x 
Bee RDAG 1 ote NO PAGE CROGU! 222 
CMP #896. , ADR MARK 37 
BME RDASNIT (TF NOT, IS {tT Ami: 
(LEAVES CARRY SET!) 5 
LDA #$0 i INIT CHECKSUM 
RDAFLD STA 
RDA. Lee x (FE OD “ODD BIT: tet 
ra tie tee NO PAGE CROSS! «22 
Bat. »Aal leh ODD BITS, 1 INTO bow 
STA 5 » (SAVE THEM) 
LDA i »READ ‘EVEN BIT’ NIBL 
RPL , ##% NO PAGE CROSS! #4% 
Atel: = MERGE ODD AND EVEN BITS 
oa aT STORE DAT& BYTE 
tick 
DE? 
BPtL RDAFLD 


i; ADDED NIBL DELAY 
GéL, x 


-LOOP ON 4 DATA DYTES 


ray -iF FINAL CHECKSUM 


Hoes 28 RDCRR HUMZERO. THEN ERPUR 

eC ee COTE 4 FIRST BLT-StiIP NUBL 

wet Rows eee NO P&Ge CRESS) eee 

CHP REDE 

BRE RDERR » ERROR IF NONMATCH 

SET » DELAY (NO TNTERUPTS FROM NOW OM) 

Des GA SECOND DIT-SLIP NIGt 

mY. ORDA S vee MO PACE CRUE! ear 

OM HENS. 

RNG RDERR 
RDEs«,T Che 
WE]: PIs 

win RWToe 
401 A SE 4e H P Ab A a O H a  a a  e 
* » Divcttiteee oa, |e 
* WRITE SUBR * 
® (16-SECTOR FORMAT) * 
* * 
errr referrer rere ore ts 


+» ERROR IF NONMATCH 
+> CLEAR CARRY ON 
NORMAL READ EXITS 


WRITES DATA FROM 
NDBUF1 AND NBUF2 


> OONGUPUN. 


een eke ee oO ee ee RE Ke ee 


yo 


FIRST NBUF2. 
HIGH TO LOW. 
THEN NBUF 1, 
LOW TO HIGH 


~~ OM ENTRY ---~ 


X-REG SLOTNUM 
TIMES $10 


Kok RRO KR OR KOK ROA OR OK OR x 


* 


sa -- ON EXIT 


x * 


CARRY SET [F ERROR 


CP 0027 076 
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(W PROT VIOLATION) 


Ge 
~] 


* 
* 
IF NO tRROR. ba 
i 

A-Rii: UNCERTAIN + 
X-REG UNCHANGED * 
Y-REG HOLDS $00. * 
CARRY CLEAR * 
* 

* 

* 

* 


nooo ASSUMES ---- 


Pe ee a 


1 USEC CYCLE TIME 


+ 
BY RRR HRT 
Gy WRITEL6 SEL - ANTICIPATE WPROT ERR 
chy TO INDICATE WRITE PROTECT ERRUR INSTEAD OF 
Loft Q&H. x INTERUPT 
LOA QPL, ; SENSE WPROT FLAG 
BME WEXIT ; BRANCH IF NOT WRITE PROTECTED 
45 WRT1 LEA #$FF » SYNC DATA 
STA QYH. X . (5) GOTO WRITE MODE 
GRA QéL, xX 1 (4) 
LEY #84 , (2) FOR FIVE NIBLS 
; (2) 
i (4) 
(3) 
64) EXACT TIMING 
3) EXACT TIMING 
WNIBL7 (19,%,6) WRITE S¥NC 
i (2) 
WSYNC (2%) MUST NOT CROSS PAGE! 
#$D5 (2) 18ST DATA MARK 
WNIBL? (15.9.4) 
#SA4 e) @ND DATA MARK 
JGR WNIBL9 1(15,9. 6) 
LDA BAD i C2) ORD DATA _MARK 
JSR WNIBL® (15,9, 6) 
L.DY #$55 (2) NBUF2 INDEX 
NOP (2) FOR TIMING 
NOP (2) 
NOP (2) 


68 WINTRPT LDA INTERUPT 
4? ORA IMASK 
70 NOP 
71 BPL SERVICE (2) BRANCH IF INTERUPT HAS OCCURED 
72 VRYFRST BMI WRTFRST (3) FOR TIMING 
73. WRIFRST LDA NBUF2,Y. 5 (4) 
74 STA G6H, X ; (5) STORE ENCODED BYTE 
LDA QéL. x ; (4) TIME MUST = 32 US PER BYTE! 
DEY BD. Doses 
BPL WINTRPT ; (3) (2 IF BRANCH NOT TAKEN) 
TYA ; (2) INSURE NO INTERUPT THIS BYTE 
BMI WMIDLE. (3) BRANCH ALWAYS 


Pa far eae 4 
BO WNTRPT1 LDA INTERUPT ; (4) POLL INTERUPT Linke 


(4) POLL INTERUPT LINE 
(3) 


(2) 


BNE VRYFRST = i; (3) BRANCH ALWAYS 


81 WMIDLE GRA I1MASK (3) 
(2) 
BMI WDATA2 + (3) BRANCH IF NO INTERUPT 
DBPL SERVICE iGO SERVICE INTERUPT. 
'S WDATA2 INY | 3 (2) 
LDA NBUFI,Y i (4) 
STA Q6H, X > (5) STORE ENCODED BYTE 
ADA QOL. X | i 64). a 
CPY #*SE4 ; (2) WITHIN 1 MS OF COMPLETION? 
BNE WNTRPT1 ; (3) (2) NO KEEP WRITTING AND POLLING 
NOP | eo") 
INY i (2) 
WDATA3S NOP (2) 
NOP sii CBD 
PHA 34) 
: PLA i (3) 
:B9 0O 02 97 LDA NBUFI,Y ; (4) WRITE LAST OF ENCODED BYTES 
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STA Q6H, X 105) WITHOUT POLLING INTERUPTS 
LDA @éL, X (4) 
LDA CKSUM > (3) NORMALLY FOR TIMING 


INY i (2) 
BNE WDATAS ; (3) 2) 
BEQ WRCKSUM (3) BRANCH ALWAYS 
WROKSUM JSR WNIBL7 : (13,9, 6) GO WRITE CHECK Gum: 
LDA #$DE -(@) DMA, BIT SLIP MARY 
vSR WNIBL9 (15,956) WRITE IT 
LDA #8AA (2) DMS, BIT SLIP MARK 
JSR WNIBLO (15,9, 6) WRITE IT, 
LDA #SEB (2) DM@ BIT SLIP MARK 
JSR WNIBL (15.9, &) WRITE IT 
LDA  #$FF cos TURN-OUFF 8 +TE 
JGR WNIGLD 184959) WRITE 11 
NOWRITE LDA G7L,x ; GUT OF WRITE MODE 
LDA QéL. x . TO READ MODE. 
RTS ; RETURN FROM WRITE 
* 
SERVICE SEC ; TREAT INTERUPTION AS ERROR 
BIT SEV ,SET VFLAG TO INDICATE INTERUPT 


VSR. NOWRITE i TAKE IT QUT OF WRITE MODE' 
Cul , COULD NOT HAVE GOT HERE WITHOUT CLI OK 
RTS 

BSL RRR ETE RRREHE EEE EEEEEE EE EEE ES 


7-BIYT NIBL WRITE SUBRS 


A-REG OR'D FRIOR EXIT 
CARRY CLEARED 


*ea oe & * 


TREE HEE REET EER EEEE EEE EES 

WNIBLF CLC i (2) 9 CYCLES, THEN WRITE 

WNIRtL.7 PHA 5 (3) 7 CYCLES. THEN WRITE 
BLS /ca) 

Up WNIBL LTA GOH. X » (8) WNIBL WRITE SUE 

/ RA Get. & ; (4) CLOBBGERS ACC NOT CARE: 
RTS 

* 

HOPE OPESOEHSHSSREEHEER EEE ED 

* 

* PRENIBLIZE SUBR 

* (16-SECTOR FORMAT) 

* 

eter reer eo eT! 


CUNVERTS 256 BYTES OF 

USER DATA IN (BUF) INTO 

ENCODED BYTES TO RE 

WRITEN CIPECTLY TO DISK 

ENCODED CHECK SUM IN 

ZERO PAGE ‘CKSUM’ 
131 
132 
153 
194 
155 
136 
137 
158 
199 
160 
161 
162 
163 
163 
165 HERETEDEEAEHEEESSEHEHEHSE HERD 
iéc PRENIBI6 LDX #82 i STARY NBUF2 INDEX 

00 ' 167 LDY #0 ; START USER BUF INDEX 
168 PRENIB1 DEY iNEXT USER BYTE 

9B 169 LDA (BUF).Y 
1790 LSR OA /SHIFT TWO BITS OF 

01 03 t71 ROL NDUF2-1.X . CURRENT USER DYTE 


Cf Page 0028 of 0170 


me- ON ENTRY ~--- 


HUF TS 2@-HYTE POINTER 
TO 254 BYTES OF USER 
DATA. 


wee ON EXIT ----- 


A- REG CHECK SUM 
X-REG UNCERTAIN 
Y-REG HOLDS O. 
CARRY SET 


eee eee eee ETHER E EES OR EE 
eee eee RHEE Ke KEKE EK 
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42 
a INTO CURRENT NBUFO 
ROL NBUF2-1,x% . DYTE 
STA NBUFI¢1,Y | (6 BITS LEFT) 
TNX -FROM O TO $55 
CPA = #$56¢ 
PRENIBI »BR If NO WRAPARQUND 
LDx #8 /RESET NBUFe INDEX 
TYA USER BUF INDEX 
BN& PRENID1 » (DONE IF ZERO) 
LDY #836 i (ACC#O FOR CHECK SUM) 
j32 PRENID3 EQR NBUFG-2. Y ji CUMBINE WITH PREVIOUS 
PREN(B2 HEF i STRIP GARBAGE BITS 
- TAY » TQ FORM RUNNING CHECK 
LDA NIBL. X >GET ENCODED EQUIV 
STA NBUF2-1,Y i REPLACE PREVIOUS 
LDA NBUF2-2. Y i RESTORE ACTUAL PREVIOUS 
Ey 
OME FRENTD 3 »LU UNTIL ALL OF NMBUFR IS CONVERTED 
ANT &S3F 
PRENIB4 FOR NBUFI+41.¥ >| NOW DO THE SAME FOF 
TAX »NIBBLE BUFFER 1 
LDA WIBL, X i TO GO ANY BACK TRACKING (NEUF IL-1) 
STA MNBUFL. ¥ 
(DA HUF Y+1. ¥ »-RECOVER THAT WHICH 15 NOW ‘PREVIOUS’ 


INY 
__BNE  PRENIB4 
TAX 
LDA NIBL, X 
STA CKSUM 
JMP SETIMEG ; ALL DONE. 


SHEE HPHEEHER MERE REE ET OO THEE 
* _ 
* POSTNIBLIZE SUBR 
* 14<SECTOR FORMAT & 
+ od 
Hh ie te ee ie ea aE ae ae a ae Se ae ge ae ab He ae HE 
* . 
POSTNIB16 LDY #855 »FIRST CONVERT, TC & BIT NIERLES 
LDA #$0 INIT CHECK Sium 
PNIRL1 L De NBUFE.LY /GET ENCODEC BYTE 
EOR DNIDL: xX 
STA NHUF2,Y »REPLACE WITH 6 GIT EQuily 
DEY 
BPL PNIBLI ; LOOP UNTIL DONE WITH NIBELE BUFFER 2 
INY NGW Y=O 
PRMIBLe i.0Dsk NBUF YT, »DO THE SAME witr 
fhe OPNIBL. xX 
Sr& NBUFLLY , WIBBLE BUFFER 1 
INY >DO ALL 236 BYTES 
BNE PNIBL2 : 
LDx CKSUM MAKE SURE CHECh SUM MATCHES 
HUR PDNIBL. x ~BRTTER BE 2ERis! 
SEC JANTICIPATE EPROF 
BNE POSTERR BRANCH IF IT 15 
LDX 46356 “INIT NBUF2 INDEX 
DEX . ;NBUF IDX $85 TO 40 
BNI POST (WRAPAROUND TF NEG 
LDe mMBUFL,Y 
LGR MBUIP ED. xX + SHIFT 2 8179 FROM 
Ro. A : CURRENT NBUFe@ NIBL 
LSR NBUFe, XxX > INTO CURRENT NBUF I 
ROL A iNIBL 
STA «BUF OLY ;BYTE GF USER DATA 
Lhy /NEAT USER BYTE 
BNE FOSTe 
cle / GOOD DATA 
POSTERR EQU * 
SETIMES LDA ENVIRON 
URé #ONEMEG 2SkT TO UNE MEGAHERT? Cilich RATE 
STA ENVIRON : 
RTS , (SEY USED TO SET VFIAG) 
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HHP RKHHHKHHAKHHHHOREHKEE HHH 
% & 
# 6-BIT TO 7-BIT # 
# NIBL CONVERSION TABLE # 
* * 
HRAHUAPHHH HHH HHRE REE 


CODES WITH MORE THAN 

ONE PAIR OF ADJACENT 
ZEROES OR WITH NO 

ADJACENT ONES (EXCEPT 
37) ARE EXCLUDED 


eR OK wk ok OK OF 


HHHRPHRKARHHHHHHAHHKEHHRHE TH 

NIBL. DFE $96, $97, $94 
DFB $98, $90, $9E 
DFR $9F, $46. $A7 
DFB $AB, $AC, $AD 
DFB AE, $AF, $B2 
DFB #83, $B4, $B5 
DFE B86, $B7, $B9 
DFR $BA, $BB, BC 
DFR #BD, $BE, $8F 
DFR $CB, $CD, $CE 
DFB CF, $D3, $D4& 
DFB D7, #D9, $DA 
DFE DE, $DC, $DD 
DFR DE, $DF, $E5 
DFR $E4, $E7, $69 
DFB %EA, SEB, $EC 
DFB SED, $EE, $EF 
DFE $F2, $F, $F4 
DEB $F, $F&. $F7 
DFE $9, SFA, SFE 
DFB SFC, $FD, $FE 
DFE FF 

CREME EEE EEE EEE HEHE RHR 


7-BIT TO 6-BIT 
‘DENTELIZE’ TABL 
.L6-SECTOR FORMAT) 


+o oe 


VALID CODES 
$94 TO $FF ONLY 


CODES WITH MORE THAN 
ONE PAIR OF ADJACENT 
ZEROES OR WITH NO 
ADJACENT ONES (EXCEPT 
BIT 7) ARE EXCLUDED 
RRA THKHAKREKKEEERAEHESEH EAH RS 
00 BRK. ONE 3YET LEFT OVER 
DNIBL EQU REGRWTS+$300 
F396:'00 01 98 DFB 00, $01, $98 
F399 99 02 03 DFB $99, $02, $03 
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$9C, $04, $05 
$66, $A0, $41 
£A2, $AQ. tha 
$A5, $07, $08 
#A8B, $A9, $AA 
$09, $04, $0B 
€0C, 0D, $80 
#1, $O0E. $OF 
#10, $11,612 
$13, $BS, $14 
$15, $16, $17 
$18,$19, $14 
C0, 801. 03 
$03, $C4. $08 
£C5.4C7 $05 
$C9, $CA, $1B 
CC, $1C, B1D 
$1E, $D0, $Di 
$D2, 81F.$n4 
$05. $20, £21 
$D8. $22. $22 
$24, $25, $26 
527. $28. FEO 
$E£1.$E2,. $623 
eS, ey. BLP 
$20. E98. $27 
$20. S2E. 20F 
$30.31, $22 
$F, $71, $259 
$34. $35, $26 
$37. $836, BFS 
$39, $3BA. 800 
DFR #2C, $3D, $3& 
DFB $3F 

MHRA EEE EHH DH Ke 

* * 

* FAST SEEK SUBROUTINE * 

+ tt 

BREE HR EHEKEEHEHRHKHHHE 


~--- ON ENTRY ---- 


X-REG HOLDS SLOTNUM 
TIMES #10. 


A-REG HOLDS DESIRED 
HALF TRACK. 
(SINGLE PHASE) 


CURTRK HOLDS CURRENT 
HALFTRACK. 


---- ON EXIT 
A-REG UNCERTAIN. 
Y-REG UNCERTAIN. 
X-REG UNDISTURBED. 


CURTRK AND TRKN HOLD 
FINAL HALFTRACK. 


CO OSSCSCSCSCSCSCSCSCSCSCSCC*S Paige 0082 OTT 


RRR EK RR KR KR RRR KR ROKR ROK 
we KR KOR RR K ROK KOR OK ROR OK OR KOKO 
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F400: 
F400: 
F400: 
F400: 
F400: 
F400: 
F400: 
F400: 
F400: 
F400: 
F400: 
F400: 
F400: 
F400: 
F400: 
F400: 
F400: 
F400: 
F400: * 
F400: HEN EKE HERES RED AREER HHH 
F400: SEEK STA TRAN i SAVE TARGET TRACK 
F402: CMP CURTRK iON DESIRED TRACK? 
F404: REQ SETPHASE ; YES, ENERGIZE PHASE AND RETURN 
F406: LDA #40 
F408: } STA TRKCNT i HALFTRACK COUNT 
F40A: 3 LDA CURTRK i SAVE CURTRK FOR 
F40C: STA PRIOR ; DELAYED TURNOFF 
F40E: SEC 
F40F: ES SBC TRKN i; DEL.TA-TRACKS 
F4it: ‘ BEQ SEEKEND ;BR IF CURTRA=DESTINATION 
F413: BO E BOG GUT (MOVE GUT. NOT Th: 
F419: EDR #3FF CALC TRAS TQ GC 
Fa177E6 INC CURTRK INCR CURRENT TRACK (IN) 
F419: 90 Z BCC MINTST (ALWAYS TAKEN). 
F418. 69 397 OUT ADC #$FE »CALC TRKS TO GO 
b4ip AC 37 DEC CLURTRK »>DECR CURRENT TRACK Chill” 
Fate be : 34 MINTY CMP TRKCNT 
F421. BCC MAXTST 64ND “TRKS MOVED’ 
Faeg } LDA TRACNT 
F425 MAXTST CMP #89 
F427 ae ane Bies> STEPO Y TF TRECHTDS8 LEAVE fF AL ONE 0 Y=$) 
F429 OTL TAY »,EL SE SET ACCELERATICIN INCEY IN ¥ 
FacA 9B a mt 
Faces . STEP. JSK SETPHASE 
F42E C LDA ONTABLE,Y .FOR ‘’ONTIME’ 
F431. JSR MSWAIT »¢€1Q00 USEC INTERVALS) 
FARA 3S z LDA PRIOR 
Page =] tic CL » FOR PHASE GFF 
er é Gk CLRFHASE TURN CFF PRIQR PHAGE 
bab BA i ? LDA OFFTABLE, Y THEN WAIT ‘OFFTIME’ 
F4a3n 9¢é H JSR MSWAIT (100 USEC INTERVALS) 
F440 : ING = TRAKCNT “TRACKS MOVED’ COUNT 
raap : BNE SEEK2 (ALWAYS TAKEN: 
F4ay YU 3 . SECAEND JSR MGSWAIT isSETTLE 2&5 MSEC 
FAQ’ chic iSET FOR PHASE OFF 
F448° : & SETPHASE LDA CURTRK i GET CURRENT TRACK 
F&GA ; CLRPHASE AND #3 i+>MASK FOR 1 OF 4 PHASES 
Fac ae FIG ROL A i DOUBLE FOR PHASEUN/OFF THDEX 
rs oo ee ee TBR es LBoLOFr 
Paap ¢ 4s TAA 
Faso PD 2 i 42.0 LDA PFPHASEGEF, xX >» TURN ON/OFF ONE PHASE 
LDX IBSLOT iRESTORE X-REG 
SEEKRTS RTS ‘AND RETURN 

SDP RH SHARHARARHHEY CHER EDT 

420 

i MSWALT SUBROUTING 


aa, 


COSC CS Page 0083 OFT 


PRIOR HOLDS PRIOR 
HALFTRACK IF SEEK 
WAS REQUIRED 


MONTIMEL AND MONTIMEH 
ARE INCREMENTED BY 
THE NUMBER OF 
10G USEC GUANTUMS 
REQUIRED BY SEEK 
FOR MOTOR ON TIME 
OVERLAP 


~~~ VARIABLES USED --~ 
CURTRK, TRAN, COUNT, 


PRIOR, SLOTTEMP 
MONTIMEL, MONTIMEH 


we ee 2 2 2 a Se, 
eK Ee KR KR KK KK KK KE eA 
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DELAYS & SPECTPIEL 
NUMBER OF 120 USFe 
STE ROVAL Pe 

Oh TUMT EG 


ON ENTRY + -+--- 


HOt MWUMEE & 
rab Gos 
rWwbe PAG TG 
el 


(WM BLT sas 


Rates 


rept DME, 


emer | 


BEGET E EEE EEE 


* 
% PHASE ON-, OFF-TIME 
* TABLES IN 100-USEC 
* INTERVALS. (SEEK) 
+ 
GERRI HR HEHEHE RHR 
ONTABLE DFB 1, $30, $28. 
DFR $24, $20, $1E 
DFR $1D, $1C, $1C 
OFFTABLE DFB €70, $2C, $26 
DFB $22, $1F,$1E 
DFB $1D, $106, $1C 
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51 
F479: 488 BLOCKIO STX IBTRK 
F47B: A 489 2. LDY. #8$5_. 
F47D. 490 PHA 
F47E 491 TRASEC ASL A 
FS7F ; 452 Roi IBTRK 
F481: 493 DEY 
F4&2: 494 BNE TRKSEC 
F484: 495 PLA | 
F485 Do 495 AND #87 
F497 497 TAY 
F488 z 498 LDA SECTABL, Y 
F483: 499 STA IBSECT 
F4spD: > 300 JSR REGRWTS 
F490: 501 BCS QUIT ; 
F492 85 SG2 tNc| | 6IBBUFP+1 
F494 E 303 INC IBSSECT 
F494 5O4 TNC IBSECT 
F498: 905 JSR REGRWTS 
F493: SOS DEC IBBUFP+1 
F49D A! 507 LOA IBSTAT 
FASE Sor RTS 
4A rine, 
FAaAAO SiO SECTADRL FOr ® 
F4A0. 20 B51 DFr #0, $4, 38 
F4A3 > G12 DFR C, #1, 85 
F4AG 913 DFR $9, %D 
fads Sis # 
F4A8 Se ee eH He ee Oe 
F4A8: * 
F4a9 


£ Ups 


JOYSTICK READ ROUTINE 


kee He PT eH He oH He HH oe F 
ENTRY ACC= COUNT DOWN HIGH 
XuY= DON’T CARE 


acre Es) 
F4ag 
F4AR 
S4A8° 
aeie ots 
FG eNS3 
are te) 
F4A8 
F4A8 
Faas 
FASS 
Fe ag, 
Faas . 
FFD? : TIMLATCH EGU $FFD9 

FFD8 ‘ TIMERIL EGU S$FFDS 

FRO? ‘ TIMERIH EQU $FFD9 

Tue 336 JOYPDY FGU $0066 

Fass aaa 3 

FAA. . ; ANALOG EGU ® i CARRY SHOULD BE SET! 

F4arn Sp STA TIMLATCH i; START THE TIMER! 

F4AR AD FE ANLOGI LDA INTERUPT 

F4AR 2D 64 CJ AND JOYRDY ;WAIT FOR ONE OR THE GTHER TO GC LOW 
[Sit Oe) ed a 14a Bit] ANLOG1 

Paty Abe ee OO 34" Dey JOYRDY -WAY IT REALLY THE JOYSTICK? 

Bei Oe aD 34 aM GODT IME »)NGPE, FORGET [T 

F483 16 CLE ;TIME’S A SLIP SLIDIN AWAY 

F4B9 AL Db: : LDA TIMER1IH »;NOW, WHAT TIME IS IT* 

F4ec A. iF LDY TIMERIL 

F4R0 Cou 3 S BPL GOODTINE > TIME WAS VALID' 

r40! pie Cc et 54! LBA TIMERLH ;HI BYTE CHANGES 

Fac se 550 GOQUTIME RTS 

eee SUCCESSFUL ASSEMBLY. NO ERRORS 
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FXIT ACC= TIMER HIGH BYTE 
y= TIMER LOW BYTE 
CARRY CLEAR 


a a a a 


IF CARRY SET, ROUTINE 
- WAS INTERUPTED & 
ea ® Y ARE INVALID 


eof F £ & & Ht RB HF RH 


PRK KK Ee eR RR EE 


xe wR ww OK 
% 


Apple Computer Inc. Patent : 4 383 296 


4,383,296 


FOE9 ALDONE ! OFLO ALL DONE | F119 ALLOFF - ANALOG 
F4AQ ANLOGI TF ATI BLOCK IG 9B RUF ; CHADRV1 
F128 CHKDRY Fi. CKBRTS 96 CKSUM CLRPHASE 
FOSO CONWAIT OC7 CORRECTSECT ?FOBF CORRECTVOL 35 COUNT 
97 CSSTV 77 CSUMT ao cSUM CURTRK 
F300 DNIBL DRIVSEL COBA DRVOEN DRVOTRK 
?7CO8B DRVIEN 25 DRVERR F13E DRVINDX DRVWAIT 
EO DVMOT - ENVIRON 9F ENVTEMP ? GOCAL1 
?FOAL GOCAL F4C4 GOODTIME ?F116 GOSEEK GOSERV 
FOE@ HNDLERKR O HRDERRS 85 IBBUFP IBCMD 
Be IBDERR $2 TRDRYVN @O IBNODRYV t IBRERR 
B84 IBSECT IBSULOT 89 IBSMOD IBSTAT 
83 IBTRK 21 IBWPER 8B IMASK - INTERUPT 
84 TOBPDN 046 JOYRDY 95 LAST NAXTST 
FOF MIMNTST A MOWTIMEH 99 MONT IMEL MOTOF 
COB38 MOTOROFF Hono NGTOROH F458 MSHI 51 MSHWe 
F494 MSWATT FLOS MYSEEK 0200 NAUF 302 NBUF2 
F395 NIBL PFO6O NODRIVERR FOSD NOINTR1 NOINTR2 
FOAC NOWRITE NXOFF F470 OFFTABLE OK 
80 ONEMEG F467 ONTABLE F41B QUT PHASEOFF 
miOuL PHASEON ? Si PHASON 7COB8O PHSOFF 5 PNIBL1 
F328 PNIBL2 736 POSTI F338 FOSTe POSTERR 
Flgli POSTNIBIS PACA PRENTD 2C6& PRENIBI6 ? PRENIB2 
FEEG PRENIB3 2FB PRENILG 9D PRIOR ( Q6H 
coee GS. C O7H COBE Q@7L 2D QUIT 
FL4pb RDI 57 RD2 Fié2 RDS RD4 
FIVE RDSA 7 3S Fi9a RDS : RD7 
FRIAR RDS -1CB RDAL Fine RBA RDA3 
FLEA RDBA4S “PFO RDA F204 RDAG : RDA? 
FiRBD RDADR1é [8 RDAFLD FICD RDASNI RDASYN 
F19D RDCKSUM “188 RDERR F2i7 RDEXIT RDRIGHT 
F143 READ1E FOC REGRWTS 93 RETRYCNT : RSYNC 
F164 RSYNC FOBB RTTRK F440 SECTARBL 78 SECT 
UR YTOS SEEKI F40A SEEK2 94 SEEKCNT SEEK 
F434 SEEKEND TR O55 SEEKRTS FeBp3 SERVICE : SETIMEG 
F449 SETPHASE F125 SETTRK F354 SEV STEP2 
fF429 STEP 97 TEMP FFD9 TIMERIH TIMERIL 
FFD? TIMLATCH 99 TRACK 95 TRACNT TRKN 
a9 TREN F47E TRASEC FOBS TRYADR2 TRYADR 
“OF R TRYTRK2 FOES TRYTRIK 7F TWOMEG 7A YOLUME 
256 YRYFRST Fe?1 WDATAL F281 WDATAR WEXIT 
SE WINTRPT F26A WMIDLE °F ORF WhIBL é WNIBL7 
2 WNIBL? F267 WNTRPT1L WRCKSUM WRITE16 
WRIT TF223 WRIT 7-258 WRTFRST WSYNC 
TWUMEG 60 IBNODRYV HRDERRS ONEMEG 
TBSLOT 8i IBWPER IDDERR IBDRVN 
TRRERR 83 IBTRK IBSECT DRVOTRK 
[BBUFP 7 IBCMD IBSTAT CSUM 
IBSMOD A ITOBPDN INASK CURTRK 
RETRYCNT SEEKCNT LAST TRACNT 
COUNT CKSUM cssTv csumt 
TEMP SECT MONT IMEL TRKAN1 
TRACK MONT IMEH VOLUME BUF 
PRIOR TRKN ENVTEMP DVMOT 
NBUF 1 NBUF2 JOYRDY ? PHSOFF 
PHASEOFF fs PHASON ? PHASEON MOTOROFF 
MOTORON DRVOEN ? DRV1IEN QéL 
Q6H E Q7L. Q7H REGRWTS 
DRIVSEL. DRYVWAIT OK MOTOF 
CONWAIT 7 NODR IVERR TRYTRK TRYTRKS 
TRYADR 5 TRYADR2 NOINTR1 : GOCAL1 
GOCAL RDRIGHT RTTRK ? CORRECTVOL 
CORRECTSECT 70 ALLDONE DRVERR HNDLERR 
ALDONE 1! 3 NOINTRe WRIT MYSEEK 
SEFK1 7 GOSEEK ALLOFF NXOFF 
SETTRIK 2B CHKDRYV »D CHKADRV1 CKDRTS 
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F13E 
Fisa 
Fi7D 
FLAS 
Fipp 
Fide 
FiFe 
F218 
F24e 
F26A 
Faac 
PR ABE 
PF OE 7 
FO1S 
F34C 
F400 
F425 
F449 
F459 
?F479 
?TF4AB 
FFD? 
OUG2 
OO0G 
GOOD 


OOOO: 
oleleren 
O2900: 
0200: 
OO01: 
Q000: 
OO10. 
GOS. 
oo19. 
QO1A: 
0087 : 
oogs: 
Gogol: 


c00s 
core 
Coss 
C04? 


COS0° 


Tih 


COGe 


CoN 


Que 1° 
COFR: 
COFS: 
MLO. 
Clo: 
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DRYVINDX 
RSYNC 1 
RDS 

RD7 
RDADR 16 
RDA2 
RDAS 
WEXIT 
WINTRPT 
WMIDLE 
NOWR ETE 
WNIBL 
PRENIR2 
PNIDBL1 
POSTERR 
SEEK 
MAXTST 
SETPHASE 
MSW1 
BLOCKIO 
ANALOG 
TINLATCH 


~ 


Poth. BROE DUC 


4,383,296 


F148 READI6 Fi4A& RSYNC 
F157 RD2 Fié2 RDS 
Fi7E RDSA F192 RDS 
FiAF RDS FiBS RDERR- 
FiCi1 RDASYN F1C8 RDA1 
FibDD RDA3 FiES RDAFLD 
F204 RDAS F20E RDA7 
F219 WRITELS ?F223 WRT1 
Fe2s6 VRYFRST F258 WRTIFRST 
Fea7i WDATA2 F281 WDATA3 
FeB3 SERVICE F2BC WNIBL? 
Feacé PRENIBDI6 F2CA PRENIBI 
FOFS PRENIBG F300 DNIBL 
F322 PNIBL2 F336 POST! 
F34C SETIMNEG F354 SEV 
F40A SEEK2 F41B OUT 
TF4a9 STEP F42B STEP2 
F44A CLRPHASE ?F4aS5 SEEKRTS 
F461 MSWe F467 ONTABLE 
F47E TRASEC F49D QUIT 
F4AB ANL.OG1 F4C4 GOODTIME 
FFD? TIMERIH FFDF ENVIRON 


REE REAR TTA RRA THE AHH ARERR 


~ 


esAth DIASMOSTIC TESt © 2uTINES 


2 eCOEYRIGHY Lie BY APROE Clie OTS 


PRR TRRECAAR ET TERRA RRR AMG 
3 FQU 84 FOR Reap vil 


(POGL+? 


LECMD 
TsghuUrP 
PREVTRE, 
Bile kG 


B1400+PTRHI 
SLSOG+ZRFGI 
£C000 
$COO8 
€CO10 
$5058 
$C047 
$CO50 
$CO51 
BCOEG 
SCODO 
SCOF I 
SCOFS 
€COFS3 
SC 100 
$C LOO 
BCSIO 
Fun 8O4O0 
EXPROM a SCFFF 
ZPREG $F FDO 
SYSDI1L cau $F FOF 


RD1 

RD4 
RDCKSUM 
GOSERV 
RDASN1 
RDA4S 
RDEXIT 
WSYNC 
WNTRPT 1 
WRCKSUM 
WNIBL7 
PRENIB3 
POSTNIB16 
PosTa 
NIBL 
MINTST 
SEEKEND 
MSWAITT 
OFF TABLE 
SECTABL 
TIMERIL 
INTERUPT 


TROELY ROM 
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57 
FFOQ: SYSDe Hai SFFDe 
FEDS. 47 SYSD2 fad sFFDS 

FREO: SYSEO EGU SFFEO | 

PREF. BNKSW EG) SFFEF 
FFE: 9 SYSE2 EQU SFFE2 
FFE: SYSES3 EQU $FFE3 
FORD: e COUT EGU #FC25 
FDO?: CROUTL EQU SFDO7 
POOF : KEYIN EGY SFDOF 
FRC?: 5 SETCVH EGU #FBC7 
; CLDOSTRT EQU $FD98 
SETUP EQU S$FD9D 
MONITOR EGU $F901 

* 


OBJECT FILE NAME IS DIAG. OBY 

60 ORG $F4C5 
B2 61 RAMTBL DFB $0, $B1, $B2, $BA, $B9, $10, $0. $13 
10 


CHPG EQU 
cD 
cD 
ci 
ag “ACIA’ 


c4 ‘A/D! 

41 ‘DIAGNOSTIC’ 
4F 

49 


‘2 


ont 
34 i ‘RETRY’ 


SYSTEM 


LDA #$52+ROM TURN OFF SCREEN, SET 2MHZ SPEED 
STA SyYSsD1 AND RUN OFF ROM 
LDX #00 SET BANK SWITCH TO ZERO 
STX SYSEO 
STX BNKSW 
STX ZPREG AND SET ZERO PAGE SAME 
DEX 
STX SyYSD2 PROGRAM DDR‘S 
STX SYSD3 
TXS 
INX 
LDA #80F 
STA SYSE3 
LDA #$3F 
STA SYSE2 
LDY #806 
LDA DISKGFF,.Y 
DEY 
DEY 
BPL DISK1 
LDA KEYED 
AND #$04 
BNE NXBYT 
JMP RECON 

+ 

* VERIFY ZERO PAGE 
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59 60 
NXBYT LDA #$01 ROTATE A 1 THROUGH 
NXBIT STA ZRPG, X EACH BIT IN THE © FG 
CMP ZRPG, X TO COMPLETELY TEST 
3 NOGOOD BNE NoOGoOD THE PAGE. HANG IF ROGOCD 
ASL A TRY NEXT BIT OF EYTE 
BNE NXBIT UNTIL BYTE IS ZERO 
INX CONTINUE UNTIL PAGE 
BNE NXBYT IS CONE 


TXA PUSH A DIFFERENT 
PHA BYTE GNTO THE 
INX STACK UNTIL ALL 
BNE CNTWR STCK BYTES ARE FULL. 
DEX THEN PULL THEM 
STX PTRLO OFF AND COMPARE TO 
PLA THE COUNTER GOING 
CMP PTRLO BACKWARDS. HANG IF 
BNE NOGCOD THEY DON’T AGREE. 
DEC PTRLO GET NEXT COUNTER BYTE 
BNE PULDT CONTINUE UNTIL STACK 
PLA IS DONE. TEST LAST BYTE 
BNE NOGCOD AGAINST ZERG. 
+ 
* SIZE THE MEMORY 
* 
LDX #$#08 ZERO THE BYTES USED TO DISPLAY 
NOMEM STA ZRPG1,X THE BAD RAM LOCATIONS 
DEX EACH BYTE= A CAS LINE 
BPL NOMEM ON THE SARA BOARD. 
* 
LDX #$02 STARTING AT PAGE 2 
NMEM1  STX PTRHI TEST THE LAST BYTE 
LDA #$00 IN EACH MEM PAGE TO 
LDY #$FF SEE IF THE CHIPS ARE 
STA (PTRLO), Y THERE. (AVOID 0 & STK PAGES? 
CMP (PTRLO),Y CAN THE DYTE BE 0’D? 
BEG NMEM2 
JSR RAM NO, FIND WHICH CAS IT IS 
STY ZRPG1,X SET CORRES. BYTE TO FF 
LDX PTRHI RESTORE X REGISTER 
INX AND INCREMENT TQ NEXT 
CPX #$CO PAGE UNTIL 1/0 IS REACHED. 
BNE NMEMt 
LDX #$20 THEN RESET TO PAGE 20 
INC BNKSW AND GOTO NEXT BANK TO 
LDA BNKSW CONTINUE. (MASK INPUTS 
AND #$0F FROM BANKSWITCH TO SEE 
CMP #$03 WHAT SWITCH IS SET TO) 
BNE NMEM1 CONTINUE UNTIL BANK ‘3° 


SCREEN 
JSR SETUP CALL SCRN SETUP ROUTINE 
LDX #%00 SETUP 1/0 AGAIN 
STX SYSEO FOR VIA TEST 
DEX PROGRAM DATA DIR 
STX SYSD2 REGISTERS 
STX SYSD3 
LDA #$3F 
STA SYSE2 
LDA #$0F 
STA SYSES 
LDX #$10 HEADING OF ‘DIAGNSTICS’ WITH 
JSR STRWT THIS SUBROUTINE 
ERRLP1 LDX #$00 PRINT ‘RAM’ 
STX CV SET CURSOR TO 2ND LIfe 
LDA #$04 SPACE CURSOR GUT 3 


CSCC *Y PGS 0088-GF OTTO 
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62 
SETCVH (X STILL=O ON RETURN) 
STRWT | THE SAME SUBROUTINE 
#$07 FOR BYTES 7 - O IN 
RAMWT 1 * 
ZRPG1,« QUT EACH BIT AS A 
#$08 * + OR ‘1’ FOR’ INDICATE BAD OR MISSING 
RAMWT2 A CHIPS SUDROUTINE ‘RAM’ RAM 
SETS UP THESE BYTES 
#$AE LmaD A ’ * TO ACC 
RAMWT 4 
#331 LOAD A ‘1’ TO ACC 
RAMWT 4 COUT AND PRINT IT 
RESTORE BYTE 
AND ROTATE ALL 8 
RAMWT 2 TIMES 
cROVUT1 CLEAR TO END CF LINE 


BPi. RAMWT1 
ZPGLSTK TEST 


TxXs 
STY BNK SW 
TYA 
STA ZPREG 
STA STKO 
INY 
TYA 
PRE 
PLA 
INy 
CPY #8$20 
Big Ze 
LDyY #$u0 
Sty gPREG 
STX PTRLO 
INX 
STx PTRHI 
TXA 
j? CMR Borie Cig 
ang DNF = ZP3 
209 CPX #%1F 
210 BNE ZP2 
All BEQ ROMTST 
21e EQU #* CHIP IS THERE, BAG ZERO Ani, STACK 
212 LDX #814 SU PRINT ‘ZP’ MESSAGE 
eta JSF MESSERR ® SET FLAG (2MH2 MODE) 
ais # 
216 * RGM TEST ROUTINE 
217 
AF 218 ROMTOT LDA #8O0 SET POINTERS TO 
Ag ale TAY $FOO9 
he aed DY REFC 
85 eel STA PTRLO 
: Bé 222 STX PTRHI SET X TO S$FF 
A2 223 LDX #SFF FOR WINDOWING 1/0 
eh 18 224 ROMTETL FOR (PTRILQ). ¥ COMPUTE CHKSUM ON 
ha ; eat CPy PTRHT EACH ROM BYTE, 
FSF6: DO 04 226 BNE ROMTET2 WINDOW OUT 
FSF8:CO BF 2a? ~~ Sh $88 RANGES FFCO-FFEF 
FSFA: DO O02 228 ROMTST2 
FSFEC: AO EF 229 ie #$EF 
FSFE: C8 == «6 @390_ROMTST2 INY | _. 
FSFF: DO Fi 231 BNE ROMTST1I 
F401:&6 19 232 INC PTRHI 
F603:D0 ED 233 #_. BNE ROMTST1 2... _.-- ee 
F405: AS 234 TAY TEST ACC. FOR O 
F606:FO O05 235 BEQ VIATST YES, NEXT TEST 
F408: A2 03 236 | LDX #$03 PRINT ‘ROM’ AND. 


F60A:20 7B F7 237 JSR MESSERR SET ERROR 
F6OD: 238 * 
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_2399_* VIA TEST ROUTINE bases wen cee 
240 * 
241 VIATST CLC SET UP FOR ADDING BYTES 


CLD . 
LDA SYSEO MASK OFF INPUT BITS 
AND #$3F AND STORE ‘BYTE IN 
STA PTRLO ____TEMPOR. LOCATION __ 
LDA  BNKSW MASK OFF INPUT BITS 
AND #$4F AND ADD TO STORED 
ADC PTRLO BYTE IN TEMP. LOC._ 
ADC ZPREG ADD REMAINING 

STA PTRLO REGISTERS OF THE 

LDA SYSD1 VIA'S 

AND #$5F (MASK THIS ONE) 

ADC PTRLO AND TEST 

aDC SYSD2 TO SEE 

ADC SYSD3 IF THEY AGREE 

ADC SYSE2 WITH THE RESET 

ADC SYSE3 CONDITION. 

CMP #$E0+ROM =E17 

BEQ ACIA YES, NEXT TEST 

LLX #$06 NO, PRINT ‘VIA’ MESS 
JSR MESSERR AND SET ERROR FLAG 


263 * ACTA TEST ROUTINE 

264 * 

245 ACTA CLC SETUP FOR ADDITION 

266 LDA #$9F MASK INPUT BITS 

267 AND ACIAST FROM STATUS REG 

268 ADC ACIACM AND ADD DEFAULT STATES 

269 ADC ACIACN OF CONTROL AND COMMND 

276 CMP #10 REGS. =107 

271 BEG ATD YES, NEXT TEST 

a72 LDX #809 NG, “ACI4’ MESSAGE AND 

273 JSR MESSERR THEN SET ERROR FLAG 

2745 * 

275 * A/D TEST ROUTINE 

276 *# 

277 ATL LDA ##CO 
Fe 278 STA $FFDC 
CO -279 LDA PDLEN+2 
co 280 LDA PDLEN+6 
co 281 LDA PDLEN+4 

282 LDY #%20 

283 ADCTSTI DEY WAIT FOR 40 USEC 

264 BNE ADCTST1L 

285. _ _ LDA PDLEN+S SET 4/D RAMP 

2A6 ADCTSTZ IN" COUNT FOR CONVERSION 

287 REQ ADCERR (> 25SSsERROR) 

ans i.DéA apra IF BIT 7 #1" 

239 BMI ADCTST3 YES, CONTINUE 

2970 TYA NO, MOVE COUNT TO ACC 

ao AND #$E£0 ACCCI2? 

292 BEG KEYPLUG 

293 ADCFRR EQuU # NO, 

24 LOY #$00 PRINT ‘A/D’ MESS 

295 JSR MESSERR AND SET ERROR FLAG 

296 * 

297 # KEYBOAD PLUGIN TEST 

298 # 

eo? KEYPLUG LDA KEYBD IS KYBD PLUGGED IN™ 

300 ASL & CTS LIGHT CURRENT 


CO OSCSCSCSCSCSCSCSCSCCC* Paige 00TOFOTT 
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SEX PRESENT?) NO, BRANCH 
SYSD1 1S ERROR FLAG SET? © 
RECON || (2MHZ MODE) NQ, BRANCH 
EPRLP 1 ERROR, HANG 
J 
2 HECONFIGUKE SYSTEM 
+ 
RECON EQU # 
LDA #877 TURN ON SCREEN 
STA SYSD1I 
JSE CLDSTRT INITIALIZE MONITOR AND DEFAULT CHARACTER 
LDA #810 TEST FOR “APPLE 1" SET 
AND KEYBD 
BNE BOOT NO, DO REGULAR BOOT 
BIT KBDSTRB CLEAR KEYBOARD 
LDA GRMD 
JSR MONITOR ANG NEVER COME. BACK 
BOOT LDx READ BLOCK © 
STx  IBCMD 
DEX 
STX IBBUFP INTO RAM AT $A000 
LDA #840 , 
STA I BBUFP+1 
SR oA /FQR TRACK 80 
STA PREVTRK MAKE IT RECALIDRATE TOO! 
TXA 
JSR BLOCKIO 
Boe SOBnOT IF WE'VE SUCCEEDED. DO IT UP 
LDt MHC 
JER GTRWT “RETR1 7: 
JSR KEYIN 
BCS BOOT 
SOBOOT IMP %AQ00 .GO TO IT FOOL. . 
4 SYSTEM GYERCISER 
S&F 
SEX LDY #$7F TRYFROM 
SEX1 TYA 7F 70 0 
AND = ADD. = 
EOR : 4EOR4F? 
; YES, SKP 


TXTMD SET TXT 
4 SLTILY __EXERCSE ss... 
SLT2, Y ALL 
SLT3, Y SLOTS 
D 349 SSLTOARV 6 er A ee es 
/AD FF CF EXPROM DISABLE EXPANSION ROM AREA 
:Cc8 
4:DO EE __ .BNE. SEX3__ 


354 # RAM TEST ROUTINE 
FOES: SS Se 85, rs dear Mes 
FOES: AF 73 356 USRENTRY LDA #$72+ROM 
F6E8: 8D DF FF 357 STA SYSD1 
F6EB-A9 18 358 — LDA #818 | 
F6ED:6D DO FF 359 “STA  ZPREQ 
F&FO: A? 00 360 LDA #800 
FOF2:A2 07 361  ———sLDX_ #807 
FoF4: 95 10 362 RAMTSTO STA ZRPGi, x 
FaF6: CA 363 DEX 
FOF7:10 FB 364 BPL__RAMTSTO 
F6F9: 20 84 F7 365 JSR RAMSET 
F4FC: 08 364 PHP 
F6FD: 20 F7 F7 367 RAMTST1 JSR RAMWT | 


F700: 20 F7 F7 348 JSR RAMWT 
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369 PLP 
370 __ROR  & 
371 PHP 
372 JSR PTRINC 
373 BNE RAMTST} 
374 JSR RAMSET 
375 PHP 
374 RAMTST4 JSR RAMRD_ 
377 PHA 
378 LDA #¢00 
379 STA (PTRLO),Y 
380 PLA 
381 PLP 
382 ROR A 
383 PHP 
384 JSR PTRINC 
385 _ _ BNE RAMTST4 
384 # 
387 # RETURN TO START 
388 * | : ee Carers 
389 LDA #00 
390 STA BNKSW 
391 = STA _ZPREG_ 
392 LDX #$07 
393 RAMTSTS t.DA PHP, X 
394 STA ZRPGIL, « 
395 DEX 
396 BPL RAMTST6 
397  ——s_JSR__ ERROR 
398 JMP ERRLP 
el Merrrrerrrrrr rrr rere rer rrr ree! 
400 * SARA TEST SUBROUTINES 
GOL RE ETE HEE STE HEHE EE SEE IEE He EE EE HH 
VO? # 
407 % GUEROUTINE STRING WRITE 
4o40 5 
405 STRWT LDA CHPG, X 
406 PHA 
40? GRA #$80 NORMAL VIDEG 
ed JSR Our & PRINT 
INX NXT 
PLA CHR 
BPL STRWT 
IMP CROUT1 CLR TO END OF LINE 


+ 

4 SUERGHI IME Kren 

‘) 

FAM Mey SV ACS 
TXA CONVRT 
LSR : ADD TO 
LSR USE FOR 
Ler . 8 ENTRY 
Lak ‘ 
ire 
_SR 
PLP 
TAX LOOKUP 
LDA &@AMTBL, * TF VSL 


CSCS CS Paige 004 OF OTT 
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REL fr rac 
f- te 

LDA mA SW 
ANT  #$60F 


BAM” 
SET 
PROPER 
RAM 
VALUE 
oA Y 
wee COME: 
Ary TO vai 


BAO 


ee 


ERG TRE PRUTEO MF or 
LUA FSP 2+FOM SET } 
eTA Sy Sti MH fat: 


Piss 


# SUBROUTINE RAMSET 
i 


RAM Y Lypax #EOL 
“ST « BK 
LDY #00 
LDA #SAA 
SEC 
PRA 
PHI 
LEA GNY 
ORA #390 
STA ITDNK 
LDA #802 
LT fs PPR 
LO #400 
wx PRED 
FiLF 

FOTeF : Pia 

FCAQ. 7 7 RTS 

PAL & 

fey US or GUERP OUT TRE PTR ING 

Fh * 

FVAL 481 PTRIMNC FHA 


C= PGS 00 FOTO 


= Oe Oe Gee 
Th Oo why OO DP 
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INC = PTRLO 
BNE RETS 
PA GNI: 
mR, Ptiged 
tone FTV T 
CMF #613 
BEG PINC2 


ate 


PIMC 


Pine t 


PANMEL fe 
avast 

PTRHT 

OMK 

te AMEE PR Re 

Raitt RRS 


é #$LO 
RAMERRS Ts BhiK St 


Fani2 ? 516 RAMERR3 RAM 


rope 


HFC 
(PTRLO). ¥ 
ZRPi31, xX 
ZRPG1.X 


RAMERRS 
RAMEE RS 
#360 


fh AMERRE 
f 
e SULROUTIME FANWT 
+ 
RAMW? EQR FF 
SOK OE TRL 
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SRP WAM, Eve CWVIRLOY. ¥ 
Ty Te $3 is Tle RAMERR 
bss 939 RTC. 


- JUCTESSPUL ASSEMBLY NO ERRORS 
ACILACN F&3E ACIA ACIACM "1 ACIAST 
ADCERR F663 ADCTST1 ADCTST3 70047 ADRS 
ADTO F653 ATD BLOCKIO BN 
BNKSW F6A1 BOOT CHPG CLDSTRT 
CNTWR FC28 COUT "DO7 CROUTI CV 
DISK1 CODO DISKOFF ERRLP ERRLP 1 
ERROR CFFF EXPROM goBoor GRMD 
IBUUFP 87 1BCMD IBNK KBDSTRB 
KEYBD FDOF KEYIN KEYPLUG KYBD 
MESSERR F901 MONITOR ‘ NMEM1 2 NNEM2 
NocooD F548 NOMEM ' NXBIT “524 NXBYT 
PDLEN 1810 PHP PINC1 PINC2 
PREVTRK 19 PTRHI PTRINC PTRLO 
PULBT F772 RAMOO RAM1 RAM 
RAMO F7DB RANERR3 RAMERRS "769 RAMERR 
RAMERR2 FVF1 RAMERRS . RAMRD RAMSET 
RAMSETI F4CS RAMTEL RAMTSTO “D RAMTSTI 
RANTST4 F7ZA RAMTST6 RAMWT 1 RAMWT4 
RAMWT FSAS RAMWT2 RECON 3 RETS 
RONTST1 FSFE ROMTST2 7 ROMTST ROM 
SETCVH FRYD SETUP * 76C4 SEX1 2 SEX 
SEX2 Fenda SEXS SILT1 SLT2 
SLT3 C490 SLT4 “FE STKO STRWYT 
SYSD1L FFD2 SYSD2 "EQ SYSEO 
SYSE2 FFE3 SYSES ; USRENTRY 
VLATST FSBE ZP1 2 ZP3 
ZPREG ZRPG1 _ 
ZRPC ROM PTRLO 
PTRHI BNK IBBUFP 
IBCMD PREVTRK IBNK 
PHP KYBD KBDSTRB 
ADRS $0 GRMD PDLEN 
ADTO DISKOFF ACIACM 
ACIACN SLT1 SLT3 
SLT4 EXPROM RAMTBL 
CHPG DISK! NXBIT 
NOGOOD CNTWR NOMEM 
> NMEM1 NMEM2 ERRLP1 

RAMWT 1 RAMWT2 ZP1 
zP2 zP3 ROMTST1 
ROMTST2 VIATST S53 ATD 
ADCTST1 ADCTST3 KEYPLUG 
RECON BOOT SEX 
SEX1 SEX2 ; USRENTRY. 
RANTSTO ! RAMTST 1 RAMTST4 RAMTST6 
STRWT RAM RAMO RAMOO 
RAM1 MESSERR ERROR RAMSET 
RAMSET 1 PTRINC PINC2 PINC1 
RETS RAMERR RAMERR2 RAMERR3 
RAMERR4 RAMERRS RAMWT RAMRD - 
MONITOR SETCVH COUT CROUT1 
KEY IN CLDSTRT SETUP ZPREG 
SYSD2 SYSD3 SYSD1 SYSEO 
SYSE2 -FFE3 SYSE3 BNKSW 

~---- NEXT OBJECT FILE NAME. IS MON. OBJ 

F7FF: r _ ORG SF7FF 

F7FF 
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a 


FE 
FOE RS 
FEBO0O0 
FBO2. 
F804 
Pte 
Pests 
~ hel “ 
(HOC 
FROE 
PSLO 
fe sees 


RTS 
SBC 
BEQ 
SBC 
REY 
SBC 
BEG 
3Be 
BEQ 
SBC 
BEG 


scat 
Swat. 


02 ONO A 


Wop 


BEY 
SEC 
BEG 
SBC 


BEG 


PQ me ee ee ee 
aa 


:~ OGO.: 


AG 


SES 
Ha oe) 
SBe 
BES 
SEC 


rye 


Mt. ¥ 


+1 
RETL 
ra 


fed 


oe 
rr ELS 
FeS. 
FS64 
FEAA 
PR ER 


CT *Y PGS 0047 FOTO 
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FE86A: BEQ 
FB6C: 10 SBC 
FRG6E: : 
Fi 7G 
Fi 2. FC 
FB74:E 
F876 

FR78 

F27A 

Fav. 

Fes 7k 

FRGO: 

FBB2. 

FSR4. 

Foe3tedy 

P28 

Fas 

FRAC. 

FSRE 

FREQ: 

PED 

Fart4 

PG 

Pee: 
FBSA, 

aoe. 


Be eS EL 
PBBO E 
FaBS 
FRE 
on 
fats 
Flies 
FARC 
FaBE 
FACO.E 
rp 


BACs 


wh HQ WN nd 


VEDI OOO ag A AN) ~ 


C= PGS 008 FOTO 
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PEM c sea RETS 
PObe: SAC 

Byes Py REG 

FAL as BBE 

PRDE BEQ@ 

raed. SBC 

er ie as 


a | 


Be Seo Las JBN TAIN A 
FOOL ® 
FOOL 


OSE 


z 
SCkROC EGU 


4a Be Us ba 


POG E: 
Ose 
oosY 
QOSA: 
QOSE: 
CHSC: 


LMARGIN &GU  SCRNLOC 
RMARGIN EQU SCRMLOC+4 
WINTOP EQU SCRNLOC+2 
WINETM EGU SCRNLOC+3 
cr EGU SCRNLOC+4 
OCED: cv EGU SCRNLOC+9 
GOSE: BASS. EGU SCRNLOC+S 
OOSF | 2 BAS4H EGU SCRNLOC+7 
C040: BASEL EQU  SCRNLOC+8 
O41: 3S BASSH EGU SCRNLOC+9 
GG: 4 TRASSL EGU SCRNLOC+EA 
OCG. 7 TBASSH EQU SCRNLOC+S2 
COa4, 8 TBASEL EQU SCRNLOC+$C 
0055: TBASBH EGU SCRNLOC+S$D 
0966. FORGND EQU) SCRNLOC+SE 
CD47: BKGND EQU SCRNLOC+S$F 
CSS: 2 MODES EQU SCRNLOC+¢10 
GOA? 3 CURSOR EQuU SCRNLOC+$11 
O0e4: 24 STACK EQU SCRNLOC+#12 
OSB: PROMPT EQU SCRNLOC+$13 
OIG : TEMP X EQU SCRNLOC+$14 
0050. TEMPY EQU SCRNLOC+$15 
CSW EQU) SCRNLOC+316 
CSWH EGU SCRNLOC+$17 
KSWL. EQU SCRNLOC+$18 
: KSWH EQU SCPNLOC+819 
GO7ea: 2 PCL EQU SCRNLOC+S$1A 
0973: 2 PCH Qu SCRNLOC+4$1B 
C7 4: Ali. EGU SCRNLOC+$1C 
379: oo ALH EGU AiL+1 
OG, Aa EGU AiL+2 
OG77: A2H EGU) AIL+3 
0078: ASL EQU) A1L+4 
OS79: ASH EGU ALL+S 
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A4SL EQU  ALL+6 
Adan EGU ALL+7 
2 STATE EO = ALL+8 
YSAV EQU A1L+9 
INBUF EQU AILL+3A i AND $B 
TEMP EGU AIL+€C 
MASK EQU CURSOR 
* 
KBD EQU C000 
KBDSTRB EQU $CO10 
* 
USERADR EQU $3F8 
BLOCKIO EQU %F479 
RECON EQU) $F 689 AS GF 12/20/79 
DIAGN EGU $F4EE 
INBUFLEN EGU $50 i ONLY BO BYTES (S$3A0-3EF ) 
IBSLOT EQU $81 
IBDRYN EQU IBSLOT+1 
IBBUFP EQU IBSLOT+4 


TIBCMD EQU) IBSLOT+é 
* 


ENTRY EQU * 
TSX 
STX STACK 


CLD ;MUST BE HEX MODE 
JSR BELL 
LDX STACK ;RESTORE STACK TO ORIGINAL LOCATION 
TXS 
LDA SDF /PROMPT (APPLE?) FOP SARA Mah Ton 
STA PROMPT 
JSR GETILNZ »GET A LINE OF INPUT 

SCAN JSR ZSTATE i SET REGULAR SCAN 

LNXTINP JSR GETNUM ; ATTEMPT TO READ HEX BYTE 
STY YSAV ; STORE CURRENT INPUT FLLHTELe 
LDy *€$31 +17 COMMANDS 

CMDSRCH BEY 
BMI MON iGIVE UP IF UNRECOGNIZABLE 
CMP CMDTAB, Y i FOUND? 
BNE CMDSRCH _iNQ AEEP LOOKING 
JSR TUSUB » PERFORM FUNCTION 
LDY YSAV »GET NEXT POINTER 
JIM XT INP + DQ WEXT COMMAND 

* 

GETNUM LDX #0 i CLEAR Ag 
STX AeL 

: STs A2H 

NXTCHR LDA CINBUFS. ¥ 
Iny ; BUMP TNDEX FOR NEXT TIME 
EOR #330 
CMP #9A i TEST FOR DIGIT 
BCC DIGIT i SAVE IT IF 1-9 
ALC #888 i TEST FOR HEX A-F 
CMP BFA 
nov DIGRET 
LDX #2 
ASL A 
ASL. 
ASL. 
ASL 4 

NXTBIT «4Si. A »SHTFT HEX DIGITS INTO Ae 
ROL Ad2t 
ROL AH 
DEX i SHIFTED ALL YET™ 
LPL, mxTSir 

NXTBAS LDA STATE 
BNE NXTBS2 , fF ZERO THEN COPY TO Al, 3 


CSCC «SY Pg 0050 OF OTTO 
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F953. 107 LDA AH, Xx 

F955: 108 STA AIH, Xx 

F957: 109 STA ASH, X 

F959 110 TNX 

F9O5A: 111 BEG NXTBAS 

FO5C ile BNE NXTCHR 

F9SE: 113 

F9SE: 114 LDA #<ASCII  iPUSH ADDRESS OR FUNCTION 
F960: 115 PHA + AND RETURN TO IT 

F961 116 LDA CMDVEC, Y 

F944 117 PHA 

F965: 118 LDA STATE iPASS MODE VIA ACC 
F967: 119 ZSTATE LDY #0 

F969: 120 STY STATE i; RESET STATE OF SCAN 
FO6B: 121 DIGRET RTS 
F96C: 122 # 

FSC: 123 CMDTAB E&QU 
F9EC: 124 DFB 
F96D: 125 DFB 
F9GE: O€ 126 DFB 
FOOSE: 127 DFB 
F970: 128 DFB 
FO? L: 129 DFB 
F972: 130 DFB 
F973: 131 DEB 
FOT4: 9 132 DFB 
F979: 133 DFB =ASCII (HI BIT ON) 
FO?6: 134 DFB =ASCII (HI BIT OFF) 
F977: 135 DFB i: =SET STGRE MODE 

F978: 136 DFB fo =RANGE SEPARATOR 

F979: 137 DFB ; =COMMAND SEPARATOR 
FO7A: 95 138 DEB ; <  =DEST/SOURCE SEPARATOR 
FOIE 139 DFB =CARRAGE RETURN 

FOTC: 140 

F9TC: 141 EGu 

F97C. 142 DFB GO-1 

FO7D: 7 143 DF = JUMP-1 

F9O7E: 144 DFR MOVE-1 

FOF: 145 DFD READ—1 

E9BO. 77 144 LFB USER-1 

FOOL: 147 DFE VRFY-1 

F9Bd: DFB WRTE-1 

F983: DER REPEAT-1 

Fo84: 4 DFR SPCE-1 

FOE: Se ; DFS ASCII-4 

FSSo:¢ : DER ASCLIO-1 

F927 B 3 DER SETMODE-1 

C958: DFR SETMODE-1 

DFG SEP-1 

LFE DGEST=-1 

DFB  CRMON~1 


=GO (CALL) SUBROUTINE 
=JUMP (CONT? PROGRAM 
=MOVE MEMORY 

=READ DISK BLOCK 

SsUSER FUNCTION 

=VERIFY MEMORY BLOCKS 
#WRITE DISK BLOCK 
=REPEAT LINE OF COMMANDS 
=SPACE (DYTE SEPARATOR) 


7HRECC VECO 


. 


t 

FIC: Ee 160 NXTAS ASL i BUMP 16 BIT POINTERS 
FPSt. NXTAI 

BOY. By ASH 

Fag) fe 7: 163 NXTAL ALL i BUMP Al 

FRM DO 35 La TSTAL 

Fide Ee 75 : ALH 

FOUR BE 4 ;IN CASE OF ROLL OVER 
FONG EO 5 


i 4 oe pe EA pe bs 
aay ft woof 


i TEST ALPAZ 


COSSCSCSCSCSCCSCCS~*S PGS GET OF OTT 
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Aas 

Aah 

TEMP 

RETAL > IF Al LESS THAN OR FQuUAL TH Ag 
1 THEN CARRY CLOG OM RETURN 


_ 180 PRBYTE | ' a __i SAVE LOW NIBBLE 
181 
182 ; i SHIFT HI NIBBLE TO PRINT. 
189. 
: 184 
:20 B7 FO 185 
 4B6 00 Bik geese pee 
187 PRHEX AND +; STRIP HI NIBBLE 
: 188 PRHEXZ ORA i MAKE IT NUMERIC 
:€9 BA 199 CCP BAC IG IT 9’ 
196 BCC PRHEX2 
191 ADC #6 iMAKE IT ’A‘-‘F’ 
) FC 192 PRHEX2 JUMP COUT 
193 * 
FO 194 PRBYCOL JSR PRBYTE 
Zxd 2 195 * gate i 
F9CS: AI B 196 PRCOLON LDA #$BA sPRINT A COLON 
F9C7:DO F6é BNE PRHEX2 i BRANCH ALWAYS 
FOO aa Re pen eee eee es 
F9C9: AF O07 iANTICIPATE — 
F9CB: 24 68 BIT MODES i TEST FOR 680 
F9CD: SO 02 | 2 Se _BYVC SVMASK 
F9OCF: AD OF LDA #$F 
F9D1:85 69 203 SVMASK STA MASK 
F9D3: 60 204 | RTS. 
F9OD4: 205 * 
F9D4: BA 206 AIPC TXA ; TEST FOR NEW PC 
F9DS: FO 07 207 — BEG OLDPC _ 
FON7: BS 74 208 A1IPCI LDA AIL, X 
F9B9: 95 72 209 STA PCL, X 
F9DB- CA 210 DEX 
F9DC:10 F9 ait BPL AI1PC1 
F9DE: 60 212 OLDPC RTS 
FODF: 2139 * | he ees ee : Seack 
F9ODF 85 69 214 ASCII1 STA MASK i SAVE HI BIT STATUS 
F9E1.A4 7D 215 ASCII2 LDY YSAV i MOVE ASCII TO MEMORY 
F9E3:Bi 7E 216 LDA CINBUF);,Y ea 
FIES: £6 7D 217 INC i BUMP FOR NEXT THING. 
F9E7: AO OO 218 LDY 
FOE? C9 AZ 219 CMP HAZ ASCII FL 
F9EB: DO O05 220 BNE ;NOPE, CONTINUE. 
FIED. AS 69 221 LDA 
FOEF.10 20 222 = si OBITON. si) HES CHANGED MODES. | 
F9F1: 60 223 RTS iNO, HE’S DONE. 
F9F2:C9 A7 224 ASCII3S CMP iASCII ’ ? 
F9F4:DO OS 225 _BNE sNO, TEST FOR EOL. 
FIFS AS &9 226 LDA 
F9FB: 30 1B 227 BMI i CHANGE MODES 
FOFA 60 = 2B RTS Penne ine eh nade Serra 
F9OFB: C9? 8D 229 CRCHK CMP + END OF LINE? 
F9OFD: FO 07 ASCDONE i VES, FINISHED 
FOFF: 25 oP ee PM po oe ed no 
FAO1: 20 AF FA 232 STOR 1 5GO STORE IT! 
FAO4: DO DB 233 ASCII2 i DO NEXT. 


CO OOSSCSCSCSCSCSCSCSCSCSCTC*S Pig 0052 TOTO 
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FAOE: 234 ASCDONE RTS 
FAO7: 295% . dente eG ada S . ., Gade 
FAOQ7 236 ASCII i INDICATE HI ON 

FAOG8 a3? $90 » (BCC - NEVER TAKEN? 
FAOS. 238 ASCIIO : » INDICATE HI OFF 

FAOA 239 CKMDE i SAVE STATE 

FAOL: 240 STATE i RETAIN STATE 

FAOD: 241 __ *#$BA i ARE WE. IN STORE MODE* 
FAO. 242. ERROR 

FAIt 243 DITON #SFF i SET HE BIT UNMASKED 
FA13 Be 2445 C ascii 

FALS: 245 DITOFF #$7F i MASK HI BIT 

FAI?. 246 ASCII i ALWAYS 

FAI? _247 REPEAT | KBD _ REPEAT UNTIL KEYPRESS 
RAT : 49 REPEAT1 

FALE 7 er. : KEYIN 

FACT of 250 REPEATL PL iCLEAN UP STACK 

FA22: , 

FALS 2Se : SCAN 

FAgS * 

FAS : - * 

FAQA 20 255 CRMON c BL1 

Pago - DSA: a MUONZ 

FAaC ¢ + 

Fag : MOVE . TSTA1 i DON’T MOVE ANYTHING IF TLi.EGAL INPUT 
& AGF : 2 ERROR 

PANTY PES MOVUNY T ry CAILY. »;MOVE A BYTE 

FAR FEO 3 (AGL? 

PNT BO : et: ISR NXTAGQ i; DUMP BOTH AL AND A4 
FANG S 2,2 MOVNXT 

AGA 244 i ALL DONE WITH MOVE 

i 


"AaB 
rATB ae 
STR 2 ey fer JSR TOTAL » TEST VALID RANGE 
SUE Doe sCS ERROR 
arti an E 2 (ALL). + COMPARE BYTE FOR BYTE 
“AG? ; 2° (A457 i MATCH? 
Fagg a? VRFY2 iYES, DO NEXT. 
Foto 29 SO ce 5 MISMATCH i}PRINT BOTH BYTES 
re AF “74 CROVUT + GOTO NEWLINE 
ar a : of NTA » BUMP BOTH Al AND AS 
PAGE 
ASL 
FAS. 


PaaS! 


VRFEY 1 
i VERIFY DONE. 

* 
MISMATCH LDA AGH ;PRINT ADDRESS OF A4 

JSR PRBYTE 

LDA AaL 

JSR PRBYCOL i; OUTPUT A COLON FOR SEPARATOR 

LDA (AGL1, 7 ; AND THE DATA 

JSR  PRBYTSP ;PRINT THE BYTE AND. A SPACE 
PRINTAL JSR PRSPC i; LEAL WITH A SPACE 
EE fast tLbA AIH ;OUTFUT ADDRESS At 
FACS 20 AD JSK PRBYTE 
FAG? LDA AIL 
F AOR JSR PRBYCOL / SEPARATE WITH A COLEN 
PAGE : PRAIBYTE LDA (AIL), Y iPRINT BYTE POINTED TO BY Al 
FA/C roOES PRBYTSP JSR PRBYTE 
FAV ao PRSPC LDA ##A0 -PRINT A SPACE 
FA75 : IMP COUT ;END VIA OUTPUT ROUTINE 
FA7B * ; 
FANS 4 Sh Beg WISER JMP  USERADR 
FATE Veh 2 
BATH 3 Ota UMP PLA 
FATO 5 J PLA ; LEAVE STACK WITH NOTHIN’ ON Tf 
FAD 2 8 co JSR i; STUFF PROGRAM COUNTER 
FAEO ¢ 2 0c JMP i JUMP TCt USER PROG 
AEB LUC & 
HAGB 201 RWERROR EQU sFRing’ ERROR NUMBER 


CP 0055 0776 


fo Ssab 
Pau? 
FASS, 
PASC: 
FASE 
FAG! 


~ 
co G5 


Oona. 
3 Pj 


= 


fe Po MFI 1) Ms 95 WDB Re 


OO a 
A 


wo. 


Apple Computer Inc. Patent : 4 383 296 


4,383,296 
90 

PAOD fd Ast Fe oe PROYTE PT i) THE OFFENDER 
FARS Al ‘ #BAL »FOLLOQWED BY A "!" 
FARE. 25 FC 3 @ COUT 
FARB O7 FD GO ERROR2 NOSTOP » OUTPUT A CARRAGE RETURN othr ta TOPL STs 
PASE OC 9d FA Foe FRROR MON 
Paact Lt 
Fayed i “GL eae Aak. Jide a2 TO Ad FOR OF GT INAT T Th Ue 
Fas} gs 309 AaL 
FAIS : AZH 
FAG? AS 7 3 44H 
FASS 4 te 
eAS 
rs Be. Re Bee PCE 2She akaATOR TEST STORE MaDe Gk tune 
PAGE 31% » ZERO MODE 
1 ASE 214. SETMDZ ) BRANCH ALWAYS 
Fey: i: 
Paes 75 i vBAY JTEST FOR NO LINE 
Pa Nope At ; Y raImeg Jf* MO LINE, GIVEM & ROW OF igy¥TeS 
FAAG Bes, a Ae ,TEST TF AFTER ANOTHER SPACE 
FAAS oan SETMDZ 
FAA?: Jie HeOA STOR! MODE™ 
FAAS ie TOO CUM ; 
PAAB So aU spe tafe oe ine! Boe fe KEEP IT If) GFORE STATE 
FAAD Bin a Ait. ee? DCTE TH BE STORES 
FAAP Gtoocs! ee Vash oath rec | ior TT TN MEMORY 
rao le 3) Ad. . BUMP POINTER 
Fess GUMMY 
rs ae , Bek ASH 
Pine Ss er Abe USEC FO ’ ie PLEA MODE 


a ares j as : eke wre pieee PNPUT CH&R Ac oat 
Pia ae 
PAGTC Gt Tel 3h CUNBUF:’. 5). TO SET MODE 
Falta 8 a's STATE 
BaAge 3 
fows : : 
fey a Sy BEAN #1 Ge) Gisn COMMAND Tl wl Ate 
FACE 2e ce $2C DUMMY BIT TO SKIF & BYTES 
ae 3 42 340 WRTE #2 : SET DISK COMMAND TO WHITE 
FACS 7 SAV MD IBCMD 
PACS aS 4a RW IP aol 
rACS m3 245 (BBW LUPMMAND FORMAT [2 
Fuse sane Ths ATH > BLUCKNUMBEP IA feos CUO OnRESS 
Peau. DY oe ITOBUFP +; 
PACK : : ASH SEND BLOCK NUMBER VIA xX #& A 
FAD1 ; ASL : 
PAD 7 3 iNO INTERVPTS WHILE IN MONT TOR 
FALE 2 ¢ f. si BLOCK IO i DO DISKO FEVER 
FAD7 RWERROR ; GIVE UP IF ERROR ENCOUNTERED 
FADS: A4aL » BUMP BLOCK NUMBER 
FADE 5 > NOVER 
belo 35 Aah 
ALY Ba 79 B54 HOVER A1H MP PA" ALDRESS Br filo ytbs 
FARL & 359 AIH 
PAE TSTAL TEST FOR FINISHED 
Fab. 4 G : RwWLOOP »>NOT DONE. DO NEXT BLACK 
[- AFL 
FAC? 3a MONSB 
FARES * , OUTPUT 1 ROW OF BYTES 
FAES9 AlLH 
FAED AGH 
BARD & , ves TSTHOWID LRT WIDTH MASK INTO ALE 
FARO ALL. 
FAR 2 a An 
FAFS DUMPO i; BRANCH ALWAYS 
PAF ¢ + 
PAFS: TSTDUMP & i; DUMP”? 
fe vab 7 ERRORSL ERROR 
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11 BUMP JSR TSTSOWIN »SET FOR EITHER 80 OF 40 IOLUMNS 
}2 DUMP: LDA ALL USE A& FOR ASCII Dirt 
STA ASL 
LDA ALH 
STA A4H 
JER FSTAL MEST FOR VALID RAidor 
b°oS ERROR 
DUMP | J9? PRINTAL PRINT ADDRESS AND © itt arte 
DUMP. JSR NXTAl 
BCS DUMPASC » ED WITH ASCIT 
LDA AL. » TEST END OF LINE 
AND Mace »FOR 40/89 COLUMN 
BNE DUMP 3 
JSR DUMP ASC 
BNE DUMP 1 » BRANCH ALWAYS 
JSR PRAIRYTE »GO PRINT NEXT BYTE AND A SPACE 
BRE DUMP2 -ALWAYS (ACC JUST PULLED AS SAO; 
sd 
DE AC LOA AL RESET TO DEGININS Gr LL TNES 
STA ATL 
LDA AdH 
ST¢é AlH 
JT PREC PRINT AN EXTRA SPACE 
Hee 1) INDEX MEMOP : TN eee Ty 
be are OORT NORMAL VIDEU 
#EAG - TEST FOR CONTROL CHARACTERS 
-G# TO PRINT NON CORIRULS 
» OTHERWISE PRINT A ZFOLE 
PUY TT TiN 
/fime BOTH Al AND Ad 
“J NISHED 
» TEST END OF LINE 


deg = .NOT DONE. PRINT NEXT 
Lhe a CRIT 
FB49- 
FB49. ; ee. 
FBa9 : , IMDICATE 80 COLUMNS DESIFED 
ras co : $0053 GOTO B80 COLUMN MONE 
i UAT = PB SET8O ij BRAHCH ALWAYS 
FB4F 
FRGF- COL.4o INDICATE 40 COLUMNS DESIRED 
FBSO- $co52 ;GOTO 40 COLUMN MODE 
FBS3 AS & S56 SETEO MODES 
PRSS Wi be 4 #$AD P ASSUME GL 
me ere SETBOA ,ANL BRAKE IF IT 1S 
FRS9 ' #$BF ; RUT FIX FOR 30 IF NOT 
FESR ‘ MODES 
FBSN #$7F ; ISOLATE BIT 7 
FREE ap #500 ; (WIT 7 SEIS NORMAL, INVERSE ' 
Fis FORGND 
Pees Be SETBOB AGAIN ASSUMES SO COLUMNS 
FRO #$FO ; IF MOT, SET FOR/BACKGROUND COLOR 
FRe? SETSOB BKGND 
FBo?: * 
Pla ad SCLSCRN | LMARGIN ,SET CURSOR TO TOP LEFT OF WINDOW 
FRek eS ) CH 
FRal as ra WINTOP 
FBOF cv ;NOW DROP INTO CLEAR END OF PAGE 
FE71 
FR71. 7 CH ; SAVE CURRENT CURSOR POSITION 
FRITS 7 
ened cy 
FB74 : ; 
FB?7: y SETCV 
FB’A CLEOP 1 CLEOL , CLEAR TO END OF FIRST LINE 
FB7D. AS LMARGIN 
FRIF CH 
FRHL 2 CURDOWN : GOTO NEXT LINE 


CO OSSSCSCSCSCSCSCSCSSCSCSCTC*S PGS 00 GF O17 
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FB84 CLEOP 1 

FBS6: 

FBS7: 

Fase. ; RESTORE CURSOR POSITION 

F369 . CH 

FBaB »GET OLD CV IN ACE AGAIN 

FRAC BE SETCY » BRANCH ALWAYS 

FBSE: 

FRE: CH ; CLEAR TO END OF LINE FIRST 

FB9Q CLEOL1 

FRYQ 

PRIS CONTROI_ #3906 

PROS “ DISPLAYX 1 TF INVERSE 

FBO? TSTCR #$9D i IF CARRAGE RETURN THEN NEW LINE 
FB9S9 TSTBACK 

FB9B CARRAGE CLEOL »FIRST CLEAR TO THE END OF THIS LINE 
PROF ao : SETCHZ RESET CURSOR AND GOT() NEXT LINE (CARRY 
FRAL 32 : MNXTL TN » THEN GOTO THE NEXT LINE. IS SET) 
Fa 

FBA4S 

FBRAS LDA » TEST FOR TOP OF SCREEM 

FBA6 DEC i ANTICIPATE ‘NOT’ TOP 

+ BAG C tae 

FRBAA RNE CURUP1 , IT’S NOT TOP. CONTINUE 

FBAC. SB WINBTM ; WRAP AROUND TQ BOTTOM 

FBAE CURUP 1_ . , DECREMENT BY ONE 

FRAF E9 01 ei 

FBB1 z z PO GE Po. ° SAVE NEW VERTICAL. LINE 

ERES SEE teas dete OF 

FB&3: CURDNE ‘ 

FBBS é 4 = ,GET VALUES FOR FIRST FAGE ($400) 
FBB5S z » ALWAYS 

FRB? 

TBR? 24 6 rate Pe ate ~TEST FOR SO OR 40 

PBB? 70 Sa tte , 

BBB i 

FBBD E 2 oa ce on oH »GUMP CUROSR HORIZONTAL. 

FRBF : 2 : 1 » TEST FOR NEW LINE 

FBO. C- * Hage OES 


94 


FROG : boy Se iate: Pe BAIN » DUST CAS: WE HAVE 
FRCS @ _ : : 

FBC? 85 Sc 3 SETCVH 3T4 : , CURSOR AT START OF NEXT LINE 
FRCS ie HDF GR INTIS iat FOR WRAP ARQUND 

FRC? Baie A. 

PROY EA Si Po a Te EE In * Move CURSOR Ditwh ONE LINE 


FROR AS ML eae La, etTiCIPATE WaT FOTTCM 
PRED 7 ne pies Dar hs WITIR TIM / TEST FOP BOTTOM 

FBCR So Be beh BCC CURDNI 

FBDY “5 J LDA WINTOP 

FBDS 8D 2 BCS SETCV / BRANCH ALWAYS 

ERS 

FOGG Ih be bapa ob te UMP #$20 , TacKASPACE” 

PR De tas 2 UNE  TSITBELL 

FRRO 2. 35 CURLLF? BIT MODES TEST FOR FORTY OR EIGHTY MODE 
FGELG 7o O82 : BVS LSeTBO : 

FaDD r BEC Ce 

PET oa. Se Lak LER TSO bio CH 

FREY Bao poe eM? LES Tir 

PEED ASF 146 LDS CH TEST FOR WRAP ARGUND 
FRE 2% CMP LMARGIN 

FRET & é BPlL. CTRLRET 

PEF 3 LEFTUP JSR  CURUP 

fice AS 4 t Dé RMARGIN 

REEL a od : STA OCH » SAVE NEW CUNSUR POSTTICN 
PRR yn E 7 BRE. CURLEFT ERANCH ALWAYS 

PRED vo# 

FREE OS couTe2 CMP #SAG -IS IT CONTROL CHARACTER 
FBF4 3 BCC CONTROL 

BRS 24 « ‘ RIT MODES -TEST FOR INVERSE 

PRP R % i 3 BMI DISrtAYX >M PUT TT OUT 
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AND FT 

DIGPLAYX JSR DISPLAY 

* 

INCHES SR CURTGHI MOVE CURSOR RIGHT 

TE ER ORL ‘3S BOTTOM. RESET CHa AND SCROLL. 
pts MEE ET CH UNL 

v 


DAST4I. 1 PRP -CAaiLT BASE ADR IN BAS4L. H 


4 »FUP GIVEN LINE NO 
#$03 iOCSLINE NO. (=617 
+#$00 i ARG2OQOOABCDE, GENERATE 
BAS4H i BAS4Hs000001CD 
“ec. 
BASGH 

i AND 
#210 » BASAL =~EABABOGO 
BSCLC2 
RS7F 
BaAS4. 
& 
A 
RAS4L 
BAS4SL 
BASSL / SAME FOR PAGE 2 


» GAVE CHAR AC TEE 
TEMPY 
TEMP xX 
IOUT 1 
TEMP Y 
TEMP x 


* 
COT! . COSWL) »>MNORMALLY COUT! 
. : 
PoPReoa 0 #$97 » BELL ™ 
{.NFD >NO TEST FOR FORM FEF 
2 oe 
Bett #310 


GEN 

RELL e | $F FDS 
DEL e 

BEL.L3 $F F US 
BELLO 


Be ace 
BOUeg 


Chow 


#354 iLINE FEED © 

YTRLRET 

“UR EOWN iMOVE CURSOR DOWN A LINE 
CTRLRET i BRANCH IF NO SCROLL NECESSARY 


WINTOP i START WITH TOP LINE 

‘SAVE IT FOR NOW 

iGET BASCALC FOR THIS LINE 

-MOVE CURRENT BASCALC AS DESTINATION 
TBAS4SL, X i (TEMPORARY BASE ADDR. ) 


SCRL2 
iGET DESTINATION LINE 
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#1. ALCULATE SOURCE 1 INE 
WINDTM S IT THE LAST LINE? 
LASTLN /YES, CLEAR IT 

,SAVE AS NEXT DESTINATION l INE 
SETCV .GET BASE ADDR-FOR SOURCE LINE 
RNARGIN  , MOVE SOURCE TO DESTINATION 


4 i DIVIDE BY 2 


#1 _4¢ 
il 


» DONE YET™ 
SR »>YES, DO NExr i Tht 
‘(BAS4L). ¥ 
‘TBAS4L), ¥ 
(BASBL), ¥Y i MOVE. BOTH PAGES 
TBASSBL).Y 
SPRL 1 BRANCH ALWAYS 


LAST TWA [0k »BUANK FILL THE LAST 2 INE 


CLEOL 1 4 i DIVIDE BY 2 


CLEGL2 
FORGND / (NORMALLY A SPACE: 
BAS4L). ¥ 
ne SND CIF 89 COLUMNS, ALSO A SPACT 
(BASBILILY 


i TEST FOR END OF LINE 
»MULT BY 2 AGAIN 


CONTINUE TF MGRE Tr oe: 
; ALL. DONE. 
+ 
DISPLAY r MODES TEST FOR 40 OR 80 
PPL i , STORE THE SINGLE CHARACTER SM— PE TURN 
4 | TNCURE PROPER 40 GOiWUMN ft. LAY 
cH DY DROPPING BIT 0 
DSPLBO , DISPLAY IN $400 PAGE 
BKGND ; ALSO SET BACKGROUND COLOR 
DSPRKGNI STA ‘ BASEL). Y 
Rey 
gr 
VEPLEG Pris PRESERVE CHAPATTER 
LDA DETERMINE WICH PAGE 
SR 
TAY 
PL e 
BCS LSPBKGND BRANCH IF $900) PAGE. 
STA (BAESL).Y 
RTS 


LOA (CINBUF), Y ECHO CHARACTER 
JSR cour 
cap #988 » BACK SPACE” 
BEG BKSPCE 
CMP #998 CANCEL” 
WEG CANCEL 
INC TEMP 
LDA TEMP 
CMP #1 NBUFLEN 
BNE NXTCHAR NG WRAF ARGUND 4éLLOWED 
CANCEL LDA ##DC ;QUTFUT BACKSLASH 
JSR cUuT 
JSR CROUT 
GETLNZ EGU #* 
LDA PROMPT 
JSR 
LDY 
STY : iSTART AT BEGINNING OF INBUF 
LDY 3 
BEG GETLN 
DEC TEMP i BACK UP INPUT DUFFE 
NXTCHAR JSR RDCHAR +GET INPUT . 
LDY TEMP 
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STA (CINSUF)D, ¥ 
CMP #€9D 
BNE NOTCR 
EQU) # 
BI¥F KBD + TEST FOR START/STOP 
BPL. NOSTOP 
Joe KEYING iREAD KBD 
emMpP tA0 +1S IT A SPACE? 
BEG STOPLST i YES, PAUSE TIL NEXT KEYPRESS 
che seb i#QUIT THIS OPERATION? 
The NGSTOP iNQ. IGNORE THIS KEY 
JME ERP ORG i YES, RESTART 
STOPLST ita j 
BPL. 
NOSTOP LDA 
JMP 
# 
RDKEY JMP 
* 
KEYIN LDA iMAKE SUFE FIRST 15 CURSUR 
STA 
JSR 3GC READ SCREEN 
AEYINI PHA iGSAVE CHRP AT CURACR 
JSR KEYWAIT i TEST FOR KEVYPRESS 
BCS KEYIN2 sGO SEI IT 
LDA CURSCR >GIVE THEM «%. UINDERSCORE FOR & TIME 
JSR DISPLAY 
JSR KEYWAIT +;GO SEE 1f KEYPRESSED 
2 KEYIN2 PLA 
PHP i SAVE KEYPRESS STATUS 
PHA 
JSR DISPLAY 
PLA 
PLP 
RCC KEYINI 
KEYING tDA KRD iREAD KEYBOARD 
FEYIMN@ RIT KBDSTRE iCLEAR KEYBOARD STROBE 
RTS 
S32 KEVWATT The TEASaL i JUST KEEP COUMTING 
333 fF KWATT2 
334 ‘tom THAS4AH 
335 LOA #S7F i TEST FOR DONE 
336 cle 
337 AND TBAS4H 
336 KEVRET i RETURN IF TIMED OUT 
339 KWAIT2 KBD 
340 KEYWAIT 
341 KEYRET 
342 * 
343 * 
344 E€SC3 
345 
346 ESCAPE |. SE} TO + SIGN FUR CUB GOR se yen 
347 
348 
349 
350 i fFEAD NEXT CHARACTER 
351 * TEST FOR ESCAPE CUMMAND 
392 ve ESCTABL. Y 
353 Esc3 
354 
355 ESc2 *#LUOP TIL FOUND GR GUPRE 
356 * 
357 RDCHAR #880 iGO READ A CHARACTER 
358 MODES 
359 CURSOR » SAVE STANDARD CURSOR 
360 RDKEY 
361 #398 i ESCAPE CHARACTER: 
* 362 ESCAPE 
363 #995 i FORWARD COPY” 


364 KEYRET 
d6S PICK i GET CHARACTER FROM SCRELI! 
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#10 i¢ 
WINBTM Is THE LAST LINE? 
LASTLN ,YES, CLEAR IT 

GAVE AS NEXT DESTINATION 1 INE 
SETCV GET BASE ADDR:-FOR SOURCE LINE 
RMARGIN 4 MOVE SOURCE TO DESTINATION 


A i DIVIDE BY 2 


» DONE YET" 
Sep »YES, DO NEXT int 
(BAS4L), ¥ 
‘TBAS4L),Y 
(BASBL),Y i MOVE BOTH PAGES 
TBASBL).Y 
GORL » BRANCH ALWAYS 
CL ASTOLM Leva G [Tl »>DLANK FILL THE LAST 2 UNE 
CLEOL1 LGR A i; DIVIDE BY 2 
TAY 
BOS CLEGLe 
LDA FOARGND » (NORMALLY A SPACE: 
LTA RAS4L).Y 
tb& Resp , CIF 89 COLUMNS, ALSO A GSP4CO 
STA (RASBLD.Y 
INY 
TrA i TEST FOR END OF LINE 
AS 4 »MULT BY 2 AGAIN 
CMF 
Bec » CONTINUE TF MGRE Te pi 
RTS i ALL. DONE. 
* 
DISPLAY BIT » TEST FOR 40 OR BO 
BUS init ; STORE THE SINGLE CHARACTER AND RETURM 
aR INSURE PROPER 40 COLUMN oo La: 
Bib CH >DY DROPPING BIT O 
JSR  DSPLBO », DISPLAY IN $400 PAGE. 
LDA BKGND ij; ALSO SET BACKGROUND COL.OF 
DSPBRKGNI' STA ‘HAGSEL).Y 
ATS 
R 
TPL Pris »PSESERVE CHAPATTER 
LDA > DETERMINE WICH PAGE 
LSR 
TAY 
PL s 
BOS DSPBKGNE: »RRANCH LF $900 Pict. 
STA (BASSL).Y 
RTS 


DA CINBUF), Y i ECHO CHARACTER 
JSR COUT 
MP #988 »BACKSPAC Eo 
BEG BASPCE 
CMP #698 » CANCEL” 
BEG CANCEL 
INC TEMP 
.DA TEMP 
oMP #1 NBUFLEN 
BNE NXTCHAR »NO WEAF AROUND -éLLGWED. 
CANCEL LDA ##DC ;OUTFUT BACKSLASH 
VSR COUT 
JSR CROUT 
GETLNZ EGU + 
GETLN LDA PROMPT 
JSR 
LDY 
Ty iSTART AT BEGINNING OF INBUF 
LDY 7 
Bea 
DEC ; i BACK UP INPUT BUFFE 
292 NXTCHAR JSR ;GET INPUT : 
293 LBY 
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CINSUF). ¥ 
#€9D 
NOTCR 
% 
KBD + TEST FOR START/STOP 
NOSTOP 
KEYINS iREAD KBD 
REAO iTS IT A SPACE? 
STOPLST i YES, PAUSE TIL NEXT KEYPRESS 
#38 iGUIT THIS OPERATION? 
NosTaP +NOQ. IGNORE THIS KEY 
i YES. RESTART 
STOPLST 


NOSTOP 


+ 
RDKEY CKSUL ) 
* 
KEYIN #E7F iMAKE SUE FIRST 15 CurRsUR 
TBAS4H 
PICK iGO READ SCREEN 
KEYINI i GAVE CRE 4&7 CURFSCR GCOLITION 
AEYWAIT i TECT FGR KEYPRESS 
KEYIN2 'GO SET iT 
CURSCR iGIVE THES “'. UINDERSCORE FOR A TIME 
DISPLAY 
KEYWAIT iGO GEE 1F KEYPRESSED 
KEYIN2 
iSAVE KEYPRESS STATUS 


TSPLAY 


KEYINI 
KEYING KBD i READ KEYBOARD 
BET Na KBDSTRE iCLEAR KEYROARD STROBE 


KEVYWAIT To TAGAL ; JUST KEEP COUMTING 
fF KWAIT2 
334 is? THAS AH 
335 LOA 8 #S7F i TEST FOR DONE 
336 cL¢ 
337 AND TBAS4H 
396 KEYRET i RETURN IF TIMED QUT 
339 KWAIT2 KBD 
340 KEYWAIT 
341 KEYRET 
34a * 
343 * 
344 ESC3 
345 
346 ESCAPE 1. : (GEL TO + SLGM ROR CUBE OR soy 
347 
348 
349 
350 ; READ NEXT CHARACTER 
35) / TEST FOR ESCAPE CUMMAND 
ase 7) ESCTABL. Y 
353 ESC3 
354 
355 Esc2 +LUOP TIL FOUND OR DORE 
356 
357 RDCHAR #880 iGO READ A CHARACTER 
458 MODES 
359 CURSOR ,SAVE STANDARD CURSOR 
360 RDKEY 
361 #898 + ESCAPE CHARACTER * 
Boe ESCAPE 
363 #395 ; FORWARD COPY? 
364 KEYRET 
PICK i GET CHARACTER FROM SCREE! 
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#$60 , SET TO NORMAL ASCII 


102 


#<CLSCRN 


ESCVECT, Y 


ESCVECT CLEOL-1 
CLEQP-1 
CLSCRN-1 
COL40-1 
~ COLSO-1 
CURLEFT-1 
CURIGHT~1 
CURDOWN~1 
CURUP -1 


CH , GET A CHARACTER AT CURRENT CURSOR POSTTIOF 
A DETERMINE WHICH PAGE 


MODES » AND TF 80 COLUMN MODE 

PICcK40 FORGET CARRY LF 40 COLUMNS 
P1CK40 VET CHARACTER FRM #400 PACE 
(BAS@L),. Y 


PICK4SO (BAS4L), Y 


* 


2 CLDSTRT £4 
3 LDF: 
4 STA ; ZERO PAGE IS ON 2! 
bo] EQuU 
6 CLD i OF COURSE! 
7 LDX #3 
STX INBUF+1 
SETUP1 LDA NMIRGQG. X 
GFFCA, X 
HOOKS, X 
STA CSWL, X 
VBOUNDS, X 
LMARGIN, X 


SETUP i 
IBORVN 
#2A0 i; INPUT BUFFER AT $3A0 
INBUF 
#560 
IBSLOT 
#EFE 
MODES 
24 COL49 .;SET 40 COLUMNS, CLEAR SCREEN 
25 * 
ADR $A0 
CPORTL ADR 
CPORTH ADR+i 
CTEMP : ADR42 
CTEMPS eae ADRs 
YTEMP Eau «DRr4 
ROWTEMP EuU 4br+20 
CWRTON FY’ 20008 
CWE TN:  €CODA 
et The ye SF FEC 
; ad “ie tPF ED 
% 
+ GENENTR #3878 i INIT SCREEN INDX LOCATIONS 
“PORTL 
#53 
SPURTH 
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EDCE #240 /SET UP INDEX [GQ CHRSET 
FDDO. eS : Y TEMP 
FDD2 #0 
tone 7 
pre “ COTE MP 0. POWTEIMP. X 
yey a? bap 
bbe u #520 
EDDA = 7IPTEMPS 


FRDC : wart #". ;FAKE THE FIRST BIT PATTERN 


T DEE 1 nt ‘PHANTOM 9TH B11 SHIFTED 43 6! 
care ee . cata : 


-UENERATE Tab ADIT 
CODES © CR Tak FTRST PASS 


Srv eC 

BAKE wR 

$AxXD=CHR 

Bex l=CHh 

BeX ysl 

passe ory 

tihkJe deo. 
iat FORT pénQe HP D 
CBYTES (OC TECORE CHARACTER TABI E 
REA GE-TSND SET OF 4 
GASTII 
42. 
hitiiars ot Hy SO Ea dee 


eo Sa akep TEL Te 


#23 5 4 CHARACTERS OF & ROWS) 
eS POR TNE COLIMING + 
iW TERE + Qk bREmrR aie. 
4 . Sy One ats 
Sok CT POR Ate Tr MOOR bah Gg 
TEMP 
YTLMP »,(NGTE CARRY iS SET! 
DONE ; BRANCH IF ALL DONE 
y TEMP , BET CHARACTEM TAIL tL PNDR 
"HRSET-1.¥ 
aA ; (CARRY KEEPS BYTE NON-ZERO UNTIL ALL E 
y CTEMP RESTORE COLUMN COUNT ARE SHIFTED) 
SHE SCNT DE .GOT ALL FIVE BITS” 
CSHE T »>NO, DO NEXT 
;ALL ROWS DONE” 
CccOLMs iNQ, DO NEXT : 
, SAVE REMAINING BIT FATTRS AND CARRY 


¢ FURCHRS »MOVE EM TO NGM PISPLAYEL VIDE AREA 
CBYTES 
e 
DONE ¢ 
STORCHRS LDX #8$1F ;MOVE CHARACTER PATTERNS TO 6iDEQ AGA 
: STURSET LDY #0 
Ve STORGW LPA ROWTEMP, X 
ae) ASL ks . SHIFT TO CENTER 
ART #836 ; STRIP EXTRA GORE AGE 
STA (CPORTL). Y 
DEX 
INY 
Ler 6888 » THIS GROUP DONF 
ME 6 SSTOROW »>NO. NEXT ROW 
jOfe | NXTPORT 
cuP 86888 
BEQ GENDONE ;ALL ROWS STORED* 
TYA 
thy. STOR PET 
of ;PARTIAL SET (84793-S85FF) 
FE44 
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105 106 
114 GENDONE LiA 1 i SET NORMAL MODE 
115 CTEMP 
116 GENL : #$00 ;PREPARE TO SEND BYTES TO CHARACTER 
Ly 2; i CWRTCN . GENERATOR RAM 
1148 Po VRETRCE ;WATT FOR NEXT VERTICAL RETRACE 
yin af #$20 iWAIT AGAIL 
L120 wl VRETRCE 
tai CWRTOFF i CHARACTERS ARE NOW LOADED 
ee 3 ALTCHR ; REPEAT THIS SET FOR OTHER 64 CHARACTERS 
V2 (C CTEMP > HAVE WE DONE ALTERNATES YET™ 
led RRL GENE inNO, DO IT! 
Ve" a a » DUMP ASCIL VALUES FOR NEXT SET 
124 a7 CrORTH 
127 NXTASCT 0 #7 i THE USUAL COUNDOWN 

NXTOSCH be (CPORTL). Y 


#$9 
(CPORTL). ¥ 


NXTASC2 
NXTPORT 
NXTASCI 


#32 ;SETUP ALTERNATE WITH UNDERLINES 
aS7F 

$SFC,Y 

$7FC,Y 


UNDER 

Ls ote bers LDA #€$8 
PR ae Ok, - 3 14 STA CPORTH 
FEY Oh ee wth BNE GENI 
PEM cg 
os TO OALTOHR LDY #7 j; ADYUST ASCII FOR ALTERNATE SET 
Fee BY Af RB AL TCA LDA (CPORTL),Y 
SEG as 7 EOR #20 =~. 3€$20-->0 %$40-->$60 
FEE. 51 : Sta (CPORTL),Y 
FE?O: Gz a ry 
FE? 1: $a Pri, ALTCL i; ADJUST THEM ALL 
FE93: 7 E 43 Jon NXTPORT 
FE?6: BCC ALTCHR 
FE9S: RTS 
FE99: * 
PESO. A! NXTPORT LDA CPLR TL i CONVERT %78->$F8 OR $FE-$78 
FESR: EDF HBG 
FESD: B85 At ‘ STA CRORTL 
FESF : BMI %GHIGH 
FEAL: INC CRORTH i IF =C THEN 24 
FEAS: A! NOHIGH LDA CRORTH 
FRAN CMP HES 
rEA?: BNE FPORTDIM 
FEAP: LDA #395 
FEAB: STA CPORTH 
FEAD: PORTDN RTS 
FEAE: * 
FEAE: * 
FEAE: 8! : > VRETRCE STA CTEMPI ij SAVE BITS TO BE STORED 
FEO: =C : 1; LDA CB2CTRL ; CONTROL PORT FOR ‘CB’ 
FEBS: AND #$3F ;RESET HI BITS TO O 
FERS: ORA CTEMP1 : 
FEB7: @n STA CBeCTRL 
FERA: LDA #88 ; TEST VERTICAL RETRACE 
FERC: ? STA CB2INT 
FERF: 2c = VWATT BIT CRB2INT i) WAIT FOR RETRACE 
FECa: F BEG VWAIT 
FEC4: RTS 
FECS: * 
FEC: CHRSET EQU 


Cf Page 0064 of 0170 


Apple Computer Inc. Patent : 4 383 296 


4,383,296 


$FO; $01. #82, $18 
$40, $84, $81, $2F 
$39, $44, $81, $29 
SO2, $1E; FOL, $91 
$7C, $1F. $49, $30 
SBA, $08, $43, $14 
$31, $24, $22, $13 
$E3, $F7,. C4, $91 
$48, $A2. SDA, $24 
$6, $4A, BE2, $UC 

DFB $24, $C6, $FB, $63 

#90, $C1, $44, $17 

$52, $BA, $A4F, $16 

$14, $E3, $33, $31 

€06, FE. $00, €73 

$3F, $46, $17, $62 

$8C. $21, $66, $18 

$44, $8D. #41, CF 

$16,$62, 674, €D1 

$B9, $18. $49, $4C 

£91,.8C0 #935. 809 

$20, $91, C0. $14 

$10, $8C. $F, $07 

$10 a0. $e. $31 

$44. $1E, SDF, $O0B 

#7). $84, $F, $FE 

2° 436, SSE. $17 

ae C FY “fo des. $80, FD, $C7 


a+ 
Loe 


20 €E- fou, SES, $OB, $51 
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Fr3R « 
FRAY OS a 2 CFE 405, $E8, $C8, $73 
FE R0 72 
FR BD , iN $18, SOC, $42, $4E 
FFA 
FFas : 22) 2 vi $01, $02, $20, $42 
PR as 
PePaee £2 Gaia FP $40. $41, $18 #8C 
FR qr oS 
a east mer fae 3 $03, 400. $70, EE 
FRAC 
FFA) Tae $00, $11, $11. $21 


$i... be 
$21, 831, £02, EO 
$1C, $00, $C8, $49 


£80, $62. $14, tir 
DFB $46, SA2, SDE. $43 


FF44 43 

FFoS 2c BLS UFR $2C, $04, $88, $BE 
FF68 BF 

FrG9 FF Fete BES $FF, $CE, $7D, $37 
FF4C. 37 

FF&D 29 22 $49, $88, $95, $18 
Re"QG le 

PPIP 8 OF 2 Lk DFR $98, $09, $62, $D1 
TF 78 

FF75 Br gt $44, $E6, $88, $FB 
FF7@ 

FF79 ) AS « $02, $90, $40, $00 
FF7C 

FF?D . re $10, $E0, $03, $02 
FFG ; ; 

FF@1 ees $00, $40, $00, $00 
FFa4 

FF85 : f $08, $00, $00, $28 
FFE 

RO Da TXB $10, $42, $44, $25 
Prac hos 

FFeD 232 3 $82, $BS, $2F, $48 
FF9O: 

FF91 $25, $44, $10, $82 
FFO4 

FFOS aerae ER $02. $00, $2F. 854 
FFOg 

FF99: : $40, $45, $02, $8E 
“FFOC: 

FF9D $64, $50, $90, $01 
FFAO: 

PFAL a a : $3E, $26, $42, $80 
FFAS 

FFAS ; $21, $80, $00, $05 
FFAS: 

FFAS. $00, $F8, $80, $00 
FFAC 

FFAD "RB $05, $08, $FS. $80 
FFBO 

FFBL: $28, $05, $88 
FFD4 

FFB4 EGU * 

EFBG: ‘ DW CcouUT2 

FFBO. DW = KEYIN 

FFBB 
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FFBS. VBOUNDS EGU ¥* 

rFBS DFB $0, $30, 0, $18 
FFDB 

FPLC * 
FrHC 4 = NMTR QO 
FF BFE 

FFCO: ‘COPYRIGHT JANUARY, 1980 APPLE COMPUTER INC... JRH’ 
FFC3 

FFCG C7 
FFCS 

FCC ck oo 
FFCF 
FFD2: 
FFDS: 
FED 

FE DB 


RECON » IN DIAGNOSTICS 


SF. Pcharet (Dick) 


FFDE: 
FFE1: Lus-ton 


( also worked. on 
Apple 30s) 


FEES, 
CFE? 
PREA: 
EFED 
MONVECT 
+ 

ESCTABL $CC 

$D0 

$D3 

. $44 

8 $B8 

88 $88 

FEES: 95 $95 

FicF7 BA $A 

FrPR OB #88 

PRE? OO $90 

FFFA 

FEFA CA FF 
EE F4 
CD FF 


NOTHING 


SFFCA 
DIAGN 
SPF CG 


»FIRST DIAGNOSTICS 


CO «SY PGS 0067 FOTO 


SUCCESSFUL ASSEMBLY: NO ERRORS 
74 ALL 


A1H 

A2H 

A4H 

AL TCHR 
ASC DONE 
ASCII 
BASSH 
DELL1 
BITOFF 
BL. 
CARRAGE 
CCOLMS 
CLDSTRT 
CLEOP 
CMDTAB 
CONTROL 
CPORTH 
CROUT 
CTEMP 1 
CURDOWN 


76 
7A 
FB2C 
FAO? 
FOF2 
60 
FCSE 
FAL 
F479 
FFEC 
5c 
FC89 
FB7A 
F97C 
FC33 
AO 
FEO7 
A2 
FBB7 


Aa 

Aa 
4SC1 
ASCcIIO 
ASCIIGS 
BASSL 
BELL2 
BITON 
BLOCKIO 
CBeCcTRL 
CH 
CLEOL1 
CLEOP 1 
CMDVEC 
couTi 
CPORTL 
CSHFT 
CTEMP 
CURIGHT 


F9D4 


ALPC 
A3H 

ADR 
ASC2 
ASCIT1 
BAS4H 
BASCALC1 
BELL3 
BKGND 
BSCLC2 
CB2INT 
CHRSET 
CLEOL 
CLSCRN | 
COL40 
CcOuUT2 
CRCHK 
CSWH 
CTRLRET 
CURLEFT 


ALPC1 


ARE 


ALTC1 
Asc3 
ASCII2 
BAS4L 
BASCALC 
BELL 
BKSPCE 
CANCEL 
CBYTES 
CKMDE 
CLEOL2 
CMDSRCH 
COL8O 
COUT 


) CRMON | 


CSWL 
CURDN1 
CURSOR 
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CURUP 1 
CWRTON 
DIGRET 
DSPBKGND 
DUMP1 | 
DUMPASC 
ERROR 
ESc3 
FORGND 
GASCI4 
GENDONE 
GETNUM 
IDBUFP 
INBUFLEN 
JUMP 
KEY IN2 
KEYRET 
KWAIT2 
LMARGIN 
MODES 
MOVNXT 
NOSTOP 
NXTA4 
NXTBIT 
NXT INP 
PCH 
PORTDN 
PRBYTSP 
PRHEX 
RDCHAR 
REPEAT 
RET2 
RMARGIN 
SAVCMD 
SCRL3 
SETBOA 
SETCY 
SETUP 
STACK 
STORCHRS 
SYMASK 
TRAST. 
TOSUL 
TSTBELL 
USERADR 
VRFY2 
WINBTM 
YTEMP 
INBUFLEN 
WINTOP 
BASAL 
TBASGL. 
FORGND 
CURSOR 
TEMPY 
KSWH 
AlH 

A3H 
YSAV 
IBDRVN 
ADR 
YTEMP 
KBDSTRB 
DIAGN 
RET2 
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FBA4 CURUP 
FA91 DEST 
FBFC DISPLAYX 
FCAD DSPL8O 
FBOC DUMP2 

?FAF9 DUMP 
FAF7 ERROR1 
FD4B ESCAPE 
FDE3 GASCI1 
FE48 GEN 

?FDC6 GENENTR 
FD77 GOESC 

87 IBCMD 
7E INDUF 
CO10 KBDSTRB 
FD2E KEYINS 
FD35 KEYWAIT 
FC87 LASTLN 

FCS2 LNFD 
F904 MON 
FFBC NMIRG 
FCB NOTCR 
FE65 NXTASC2 
F959 NXTBS2 
FCO2 NXTLIN 

72 PCL 
FASE PRAIBYTE 
2F9C5 PRCOLON 
FA61 PRINTAL 
FDOC RDKEY 
FA21 REPEAT 
FBZ RET 

B4 ROWTEMP 
F912 SCAN 

$8 SCRNLOC 
FB53 SETEO 

?PFBC7 SETCVH 

FDA2 SETUP 1 
7C STATE 

FEQC STOROW 
63 TBASSH 
&C TEMPY 

F9CO TSTAIOwWL 

?FB97 TSTCR 
FA7B USE 
FASB VRFY 

2a WINTOP 
EDOS ZIPTEMPS 

$8 SCRNLOC 

5B_WINBTM 

SF BAS4H 

63 TBAS4H 

67 BKGND 

6A STACK 

bE CSWL 

72 PCL 

76 A2L 

7A AAL 

7E INBUF 

85 IBBUFP 

Al CPORTH 

B4 ROWTEMP 
CODA CWRTOFF 
F489 RECON 
?F901 ENTRY 


cv 
DIAGN 
DISPLAY 
DUMMY 
DUMP3 
ENTRY 
Escl 
ESC TABL 


INCHORZ 
KBD 
KEYING 
KSWH 
LEFT8O 
MASK 
MONZ 
NMI 
NOVER 
NXTASCI 
NXTCHAR 
NXTPORT 
PICK4O 
PRBYCOL 
PRHEX2 
PROMPT 
READ 
RESET 
RETAL 
RWERROR 
SCRL1 
SCROLL 
SETB0B 
SETMDZ 
SHFTCNT 
STOPLET 
STORSET 
TEAS4L 
TEM 


92 TOTAl 


‘fs TRUMP 
YBCUNDS 
VREYS 
WRTE 
TETATE 


LMARGIN 


USERADR 

CWRTON 

RET1 
{IN 


CWRTOFF 
DIGIT 
DONE 
DUMPO 
DUMPS 
ERROR2 
ESCc2 
ESCVECT 
GASCI3 © 
GENASC | 
GETLNZ i 
HOOKS | 
IBSLOT 
IRQ 
KEYINI 
KEYIN 
KSWL 
LEFTUP 
MISMATCH 
MOVE 
NOHIGH 
NXTAL 
NXTBAS 
NX TCHR 


= OLDPC 


PICK 
PRBYTE 
PRHEXZ 
PRSPC 
RECON 
RET1 
RIGHT 
RWLOOP 
SCRL2 
SEP 
SETCHZ 
SETMODE 
SPCE 


7 STORL 
2 STON 
53 TRAGEH 


TEMS Y 
TSTBACHK 
UNDER 


. VRETRVE 


VWAIT 
YSAvV 


RMARGIN 


CTEMP 1 
KBD 
BLOCKIO 
RETS 
MONZ 
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SCAN NXTINP F91C CMDSRCH F920 GETNUM 
NX TCHR DIGIT F947 NXTBIT F94F NXTBAS 
NXTBS2 TOSUB F967 ZSTATE F9S5E DIGRET 
CMDTAB CMDVEC F98C NXTA4 FISD NXTAL 
TSTAL RETAIL F9AC PRBYTE PFOBS PRHEX 
PRHEX2 =G PRHE 42 FSC2 PRBYCOL TF9OSDS PRCOLON 
TSTEOWID SVMASK F9D4 ALPC FOD? A1LPC1 
QLDPC ASCIT1 F9EL ASCIT2 FOF2 ASCTI 
CRCOHK ASC DONE FAQ7 FAO? ASCIIA 
CKMDE im BiTOQm FALS FAL? REPEAT 
REPEAT 26 CRMON FAC FSi MGOVNET 
VRFY FASG VRFY1 PAAC FASE MISMATCH 
PRINTAL - PRALBYTE FA7O FAY 3 PROP 
USER y JUMP FA7D FASS RWERKOR 
ERROR2 ERROR FAP I FAVA SEF 

; BLY c SPCE SF AAG 51 FAAR STOR i 
GUMMY "AB are r ABD FAC READ 
WR TE TPAC AYOME FAC? ADR NCR 
DUMPS feroun FAF7 PRAFS DUMP 
BUMPO FPA ¢ : FROC FRiC DUM 3 
DUMPASC FBe : FB35 Fegan AST? 
TOLBS “i Ls FBS3 SE FESe SETSOA 
SETSOE : BOP FB? 1 FETA CLEP! 
CLEUL PRO] CONTROL TE BO? TRBSL CARRASE 
SORUP 2 CURUP 1 FRBI SETCY FREES SURENY 
BASTALC “GBY CURTIGHT FBRBD RIGHT! C3 SETCH 
SETOVE “BOF CURDUWN FRDS TSTBACK FRUY CURLEF 
LEF TSS FBG? LERTUP FBFa2 CQuT2 FRFO DLSPLAY 
ENOCHOR £ FOC NETILIN FCOS BASCALC}) i 
CTRLEET Pela COUT FOGS COUT] B34 TSTPSLL 

» WELL FCSD BELLI FCSE BELL2 $3 BRL 
CNET PlSB SCROLL FO61l SCRLI Oo SCR? 
SRL KR 7 LASTLN FCS9 CLEOLt ‘OL ee 
MLSP Leas Flas ECSPSE SND FCAD DSPLBO FOR NOT 
TAMNIEL. MITES GETILN FEDS GETLNZ FTES 
MY TOHAE: LER OCROUT FOS2 STOPLST PPD SY 
FONE Y POOF KEVIN Pop1ld KEYIME FUSS 
KY THB TEDL KEY INS FD35 KEYWAIT FOF 
AE YRET FY ESC FD4B ESCAPE 7FDS3 
EGSte Pied RECHAR Fp77 GOESC FO7F 

3 PTCK MoS PECKh4a “FOR CLDSTRT TEDSO 
SETUP 1 "FE DCS GENENTR FDDS ZIPTEMPS FDEL GENASC 
GASCI1 PUES GASCTe FRE? GASCI3 FDF4 GASCT4 
CBYTES FEROS CCOLMS FEO? CSHFT FELA SHE TONT 
OMe: FE28 STORCHES FE2ZA STORSET FE2C STORQW 
GENDONE FE48 GENI FES3 NXTASCI FESS NXTASC2 
GEN2 FE79 UNDER FE88 ALTCHR FEBA ALTO 
NXTPORT FEA NOHIGH FEAD PORTDN FEAE VRETRCE 
VWATT FECS CHRSET FFB4 HOOKS FFBB VEBQUNDS 
NMIRG FFEC CB2CTRL FFED CB2INT FFFO ESCTABL 
NMI ?FFFC RESET TFFFE IRQ 
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I claim: 

1. In a digital computer which includes a central 
processing unit (CPU), a random-access memory 
(RAM), an address bus interconnecting said CPU and 
RAM such that said CPU addresses locations in said 
RAM and a data bus interconnecting said CPU and 
RAM, said CPU for certain functions addressing prede- 
termined locations in said RAM with a predetermined 
range of address signals, an improvement comprising: 

detection means for detecting said predetermined 

range of address signals, coupled to said address 
bus; 

register means for storing digital signals, coupled to 

said data bus, and; 

switching means for coupling said digital signals 

stored in said register means to said address bus 
when said detection means detects said predeter- 
mined range of said address signals; 

whereby data for said certain functions normally 

stored by said CPU in said predetermined locations 
may be stored elsewhere in said RAM, thereby 
enhancing the performance of said computer. 

2. The improvement defined by claim 2 wherein said 
detection means detects all binary zeros. 

3. The improvement defined by claim 1 wherein said 
switching means comprises a multiplexer controlled by 
said detection means for selecting said register means. 

4. The improvement defined by claim 1 including a 
read-only memory coupled to said address bus and said 
data bus. 

5. The improvement defined by claim 4 wherein said 
stored signals in said register means provide a pointer 
for locations in said RAM during a direct memory ac- 
cess transfer. 

6. The improvement defined by claim 5 wherein said 
read-only memory in response to signals on said address 
bus provides instructions to said CPU causing it to 
increment address signals during said direct memory 
access transfer. 

7. In a digital computer which includes a central 
processing unit (CPU), a random-access memory 
(RAM), an address bus having a first plurality and a 
second plurality of lines for coupling said CPU with 
said RAM, and a data bus interconnecting said CPU 
and RAM, said CPU for certain operations addressing 
predetermined locations in said RAM with address 
signals on said first plurality of lines by coupling a pre- 
determined address on said second plurality of lines, an 
improvement comprising: 

register means for storing signals, coupled to said data 

bus; 

multiplexing means coupled to said second plurality 

of lines and said register means for selecting signals 
from one of said second plurality of lines and said 
register means; 

logic means coupled to said second plurality of lines 

and said multiplexing means for causing said multi- 
plexing means to select signals from said register 
means when said CPU couples said predetermined 
address on said second plurality of lines; 

whereby said signals from said register means pro- 

vide alternate locations in RAM for storage associ- 
ated with said certain operations. 

8. The improvement defined by claim 7 wherein said 
predetermined address is all binary zeros. 
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9. The improvement defined by claim 7 including a 
read-only memory coupled to said address bus and said 
data bus. : 

10. The improvement defined by claim 8 wherein said 
stored signal in said register means provides a pointer 
for locations in said RAM during a direct memory ac- 
cess transfer. 

11. The improvement defined by claim 9 wherein said 
read-only memory in response to signals on said address 
bus provides instructions to said CPU causing it to 
increment address signals during said direct memory 
access transfer. 

12. In a digital processor used in conjunction with a 
display, said processor including a data bus and an ad- 
dress bus, a memory comprising: 

a first plurality of memory devices for storing data, 

coupled to receive data from said data bus; 

a first memory output bus coupled to receive data 

from said first plurality of memory device; 

a second plurality of memory devices for storing data 

coupled to receive data from said data bus; 
a second memory output bus coupled to receive data 
from said second plurality of memory devices; 

addressing means coupled to said address bus for 
providing address signal for addressing said first 
and second plurality of memory devices; 
first switching means for selecting data from one of 
said first and second memory buses for coupling to 
said data bus, said first switching means coupled to 
said first and second memory bus and said data bus; 

second switching means for selecting data from said 
first and second memory buses for coupling to said 
display, said second switching means coupled to 
said first and second memory buses and said dis- 
play; and, 

circuit means for coupling one of a selected said first 

and second memory buses to said addressing means 
such that data from said selected one of said buses 
provides addressing information for selecting sub- 
sequent locations in said memory devices when 
said data bus is receiving data from the other of 
said memory buses, 

whereby said memory provides data for a high reso- 

lution display and whereby some data stored in said 
memory is used for remapping locations in said 
memory. 

13. The memory defined by claim 12 wherein said 
circuit means comprises a multiplexer, said multiplexer 
selecting between said data from said selected one of 
said buses and bank switching signals coupled to said 
multiplexer. 

14. The memory defined by claim 13 wherein said 
multiplexer is controlled by a logic circuit which is 
coupled to said address bus and said selected one of said 
buses. 

15. The memory defined by claim 14 wherein said 
logic circuit causes said multiplexer to select said bank 
switching signals each time said processor switches an 
OP code. 

16. In a digital computer with a memory, which is 
used in conjunction with a raster scanned display, said 
display including a digital counter which provides a 
vertical count representative of the horizontal line 
scanned by the beam for said display, said memory 
providing data for displaying rows of characters, an 
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addressing means coupled to said memory for scrolling 
displayed characters, comprising: 

an adder having a first and a second input terminal, 
the output of said adder providing a portion of an 
address signal for said memory, said first terminal 
of said adder being coupled to receive the lesser 
significant bits of said vertical count; 

said computer providing a periodically repeated se- 
quence of digital numbers coupled to said second 
terminal of said adder, said sequence of digital 
numbers provided by said computer having a maxi- 
mum value equal to the number of scanned lines in 
each of said rows, 

whereby the characters on said display are scrolled 
with a minimum of movement of data within said 
memory. 

17. The addressing means defined by claim 16 
wherein said sequence of digital numbers is incremented 
for each displayed frame. 

18. In a ditital computer which includes a single chip 
central processing unit (CPU), a random-access mem- 
ory (RAM), an address bus interconnecting said CPU 
and RAM such that said CPU addresses locations in 
said RAM, and a data bus coupled to said CPU and 
RAM, said CPU for certain functions addressing the 
zero page in said RAM by providing binary zeroes on 
certain lines of said address bus; an improvement com- 
prising: 

a detection circuit for detecting said binary zeroes on 

said certain lines of said address bus; 

a register for storing digital signals, said register cou- 
pled to said data bus for receiving digital signals 
from said data bus; and, 

a multiplexer for selecting between said digital signals 
stored in said register and said certain lines of said 
address bus, said multiplexer being controlled by 
said detection circuit so as to select said register 
when said binary zeroes are detected on said cer- 
tain lines of said address bus; 

whereby data for said certain functions normally 
stored on page one of said RAM, may be stored 
elsewhere in said RAM, and still easily addressed 
by said CPU. 

19. The improvement defined by claim 18 wherein 
one of said stored signals from said register is coupled to 
said multiplexer through an exclusive OR gate, said gate 
being coupled to one of said certain lines of said address 
bus. 

20. The improvement defined by claim 18 or 19 
wherein said computer provides an alternate stack sig- 
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nal and wherein said detection circuit also detects ad- 
dresses for page one on said address bus, and said multi- 
plexer selects said register if said page one addresses are 
detected and said alternate stack signal is in a predeter- 
mined state. 


21. In a digital computer which includes a central 
processing unit (CPU), a random-access memory 
(RAM), an address bus interconnecting said CPU and 
RAM such that said CPU addresses locations in said 
RAM and a data bus interconnecting said CPU and 
RAM, said CPU for certain functions addressing prede- 
termined locations in said RAM with a predetermined 
range of address signals, an improvement comprising: 

detection means for detecting said predetermined 

range of address signals, coupled to said address 
bus; 

register means for storing digital signals, coupled to 

said data bus, and; 

switching means for coupling said digital signals 

stored in said register means to said address bus 
when said detection means detects said predeter- 
mined range of said address signals, said switching 
means also for coupling said digital signals stored in 
said register means to said address bus when a 
certain direct memory access (DMA) signal is in a 
predetermined state; 

read-only memory (ROM) coupled between said 
address bus and said data bus, said ROM in re- 
sponse to signals on said address bus providing 
instructions to said CPU on said data bus to cause 
said CPU to increment address signals when said 
DMA signal is in said predetermined state; 


said register providing a pointer for locations in said 
RAM when said DMA signal is in said predeter- 
mined state, and said register providing RAM ad- 
dress signals when said certain functions are se- 
lected by said CPU, 


whereby data for said certain functions normally 
stored by said CPU in said predetermined locations 
may be stored elsewhere in said RAM, thereby 
enhancing the performance of said computer. 


22. The improvement defined by claim 21 wherein 
said switching means comprise a multiplexer which 
selects said register when said detection means detects 
all binary zeroes or when said DMA signal is in said 


predetermined state. 
s ¢ £ & & 
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Apple /// ROM Information 


APPLE /// ROM INFORMATION 


by 
David Craig 
7% bdgewater, hichi<a ; Kansas 67230 


1986 


This document describes the Apple /// microcomputer ROM organization. The ROM 
listing used was from Apple Computer's patent (# 4,383,296) of May 10, 1983 as 
assigned to Wendell B. Sander. The ROM listing appears to be from December 20, 1979. 


The ROM occupies 4K bytes of memory in the address range SFOO0-—-SFFFF. This ROM 
is used by the Apple /// at system power-up to test various hardware components, 
initialize the character generator bitmap, and boot SOS (Sophisticated Operating 
System) from the Apple ///'s internal floppy diskette drive. 


The ROM is organized as follows (routine names in lowercase were created by me 
since the source code did not contain a name at the particular location): 


Addresses | Name | Description 


Read/Write a disk track and sector 
Set slot dependent track location 
Check if disk motor 1s stopped 
Get index to drive number 

Read disk sector 

Interrupt service vector 

Read disk sector address field 


FOQO0-F 124 | 
F125-F12A | 
F12B-F 13D | 
F13E-F 147 | 
F148-FiBg | 
FIBA-F1BC | 
F1BD-F218 | RDADR16 
F219-F2B2 | WRITE16 Write disk sector 
F2B3-F2BB era Interrupt servicer 

| 

| 

| 

| 

| 

| 

| 

| 

| 


REGRWTS | 
| 
| 
| 
| 
| 
| 

F2BC-F2C5 WNIBLO | Write 7-bit nibbles to disk 
| 
| 
| 
| 
| 
| 
| 
| 
| 


SETTRK 
CHKDRV 
DRVINDX 
READ 16 
GOSERV 


F2C6-F310 PRENIB16 Pre-nibblize disk sector data 

F311-F354 POSTNIB16 Post-nibblize disk sector data 

F355-F395 NIBL 6-bit to 7-bit nibble conversion table 
F396-F3FF DNIBL 7-bit to 6-bit denibbleize conversion table 
F400-F455 SEEK Disk track seeker 

F456-F 466 MSWAIT 100 microsecond delayer 

F467-F46F ONTABLE Disk phase ON time table (in 100 microsecs) 
F470-F 478 OFF TABLE Disk phase OFF time table (in 100 microsecs) 
F479-F49F BLOCKIO Read/write a disk block (2 sectors) 
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Apple 4// ROM Information 


F4A0-F4A7 SECTABL 
F4A8-F4C4 ANALOG 
F4CS-F4CC RAMTBL 
F4CD-F4ED CHPG 
F4EE-FS23 DIAGN 
F524-F531 NXBYT 
FS32-F54S CNTWR 
F546-F574 memsize 
FS75~FSB9 ERRLP 
FSBA-FSE6 zpgstktst 
F5E7-F60C 

F60D-F63D 

F63E-F6S2 

F653-F67A 

F67B-F688 

F689-F6C1 

F6C2-F6ES 

FSE6-F737 

F738-F 747 

F748-F77A 

F77B-F783 MESSERR 
F784-F7A0 RAMSET 
F7A1-F7C8 

F7C9-F7F6 


| Block to sector conversion table 
| Joystick read routine 

| RAM test bytes 

| Hardware component phrases (eg “RAM”, “ROH“,. 
| ROM system power-up entry (calls RECON [F689] \a 
| Test RAM page 0 (Zero Page) 
| Test RAM page 1 (Stack Page) 
| Size the RAH 

| Display screen error line (“DIAGNOSTICS") 
| Test RAM zero page & stack page Fost 
j Test ROM hardware 

| Test VIA hardware 

| Test ACIA hardware 

| Test A/O hardware 

| Test keyboard plugin 

| Reconfigure system (tests for Apple-1 key) 
| System exerciser 

| Main RAM tester 

| Error message string writer 
| Determine size of RAM 

| Display error message 

| Setup RAM 

| Increment extended addressing pointer 
| RAM error handler 
FUFT-FUFF | RAM write 

F600-F900 | Nested RTS ‘table’ routine 
FQ01-F92B | SARA Monitor entry point 
F92C-F95D | Get number from user 
FO2E-FO6B | Execute Monitor command 
F96C-F97B | Monitor command code table 

FO7C-FO8B | Monitor command vector table (byte-long entries) 
FO8C-FSAB | Increment 2 byte pointer 

FOAC-FOC1 | Output a byte to screen 

FOQC2-F9C8 | Output a byte followed by a colon 

FOCO-F9D3 TST8OWID { Test for 80-column screen width 

F904-FODE A1PC | Test for new P.C. 

FODF-FA06 ASCII1 | Store user ASCII string into memory 

FA07-FA2S ASCII | Fetch ASCII character from keyboard 

FA26-FA2B CRMON | Dump line of hexadecimal bytes due to user CR 
FA2C-FA3A MOVE | Move bytes around in memory 

FA3B-FAS1 VRFY | Verify memory byte range 

FAS2-FA77 MISMATCH | Output verify mismatch data line 

FA7TB-FATA USER | User control vector 

FA7B-FAB2 JUMP | Transfer control to user routine 

FA83-FA90 RWERROR | Output error number 

FAQ1-FAS9 DEST | Copy source pointer to destination pointer 
FAQA-FAB7 SEP | Test for seperator character in input line 
FAB8-FABF SETMODE | Setup user mode 

FACO-FAE8 READ | Handle Monitor READ disk block command 
FAEQ~FB20 BUMPS | Output line of memory bytes 

FB21-FB48 DUMPASC | Output line of memory bytes as ASCII 

FB49-FB4E COL8O | Setup 80-column display mode 

FB4F-FB92 COL 40 | Setup 40-column display mode 


Apple “77 Information by David Craig (1966) 


CO OOCCSCSCSCSCSCSCSCSCSCC*S PGS 007 GF OTTO 


Apple Computer Inc. Patent : 4 383 296 


Apple 1 ROM Information 


FB93-FBA3 
FBA4-FBB6 
FBB7-FBCE 
FBCS-FBD4 
FBDS-FBDB 
FBD9-FBF 1 
FBF2-FC04 
FCOS-FC24 BASCALC1 
FC25-FC32 
FC33-FC35 
FC36-FCS1 
FCS2-FCSA 
FCSB-FCOC 
FCS0-FCAC 
FCAD-FCBA 
FCBB-FCD4 
FCDS-FDOB 


Handle user control character input 

Handle cursor up motion 

Handle cursor right motion 

Handle cursor down motion 

Handle backspace motion 

Handle cursor left motion 

Output character to screen 

Compute character base address for screen output 
Output character to current output device 
Character output vector 

Handle BELL character output (beep speaker) 
Handle LINE FEED character output 

Seroll screen lines 

Display character on 40-column screen 
Display character on 80-column screen 
Handle non-control character output 

Read user ASCII line from keyboard 


FDOF-FD47 
FD48-FDSF 
FD60-FD76 
FD77-FD7E 
FO7F-FD87 
FD88-FD97 
FDO8-FDCS 
FDC6-FEAD 
FEAE-FEC4 
FEC5-FFB3 
FFB4-FFB7 
FFB8-FFBB 
FFBC-FFBF 
FFCO-FFEF 
FFFO-FFFO 
FFFA-FFFB 
FFFC-FFFD 
FFFE-FFFF 


Read raw keyboard key 
Handle ESC character cursor motion 
Read keyboard character 
ESC key cursor motion handler 
ESC key editing command key code table 
Read character from current cursor location 
Cold boot system (initialize ROM globals) 
Load character generator RAM with bitmap 
Wait/poll for CRT vertical retrace 
Character generator character bitmap table 
Output/Input vectors 
Screen dimension bounds (0, 80, 0, 24) 
NMI request vector (JHP RECON [F689] RTI) 
Apple Computer, Inc. 1980 copyright phrase 
nae character table 

vector [FFCA] 
na vector [F4EE] (Power-up Diagnostics) 
IRG vector [FFCD] 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
FDOC-FDOE | Read keyboard key input vector 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| NM 
| 
| 


——— The End -—— 
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BO2B| ESSE SEE SACK ECE CE KES EEE EE CEEESE EEE EEK EK EEE CE KEK EEE ES 
2O08 | ;@ APPLE /// ROM ~ DISK I/O ROUTINES 

2O0B| ;7@ COPYRIGHT 1979 BY APPLE COMPUTER 

2B | : PPETTTTTETITTTTCITITITTTTTTL TT TTT eT ETE TTL TTT 
BOOB | 

BOOB | . ABSOLUTE 

BOB | .PROC DISKIO 

2223 | .ORG BF BBS 

2200 | 

FOO} SHAK KKKKKKAEKEKKKEKKKEKRKKE KK KK KK 

FOOO| CRITICAL TIMING 
FOOO| REQUIRES PAGE BOUND 
FORO | CONSIDERATIONS FOR 
FO20| CODE AND DATA 
FORS| 
FOOB| 
FOSS | 
FQOO| 
FO0O| 
F908 | 
FORO | 
FOOO| 
FOO8| 
FOOO| 
FOOD | 
FOOO| 
FOSO| 
eral 
FOO8| 
FOOB| 


wees 


VIRTUALLY THE ENTIRE 
‘WRITE' ROUTINE 
MUST NOT CROSS 
PAGE BOUNDARIES 

CRITICAL BRANCHES IN 
THE 'WRITE', 'READ', 
AND 'READ ADR' SUBRS 
WHICH MUST NOT CROSS 
PAGE BOUNDARIES ARE 
NOTED IN COMMENTS 


OR IORI I OO tok 


Sere ire i ri i ri reac 


EQUATES 


OO OR Ok OR OR OF OR Oe OO OOF 


on 


F2SS | 
F222 | 
FOOD] 
POS 
FLOSS! 
FRR 
F228 | 
FQSS I 
FZPD | 
FRSS I 
FRED} 
PQS 
PQS 
F282 | 
F2PD| 
FZWB 
FQP2] 
FSBD| 
F282 
F282 
F222 
F2S8 
FOOD 
F2OD 
FQOS 
FOS 
FSCO 
FASS 
F2SS 
F2SD 
FOSS 
FOOD 
FOSS 
FRA} 
F2SO | 
FOS 
F222 | 
F2PS| 
FOSS! 
FOOB| 
F2SD | 


NBUF1 
NBUF2 


HRDERRS 
DVMOT 


IBSLOT 
IBDRVN 
IBTRK 
IBSECT 
IBBUFP 
IBCMD 
IBSTAT 
IBSMOD 
CSUM 
IOBPDN 
IMASK 
CURTRK 
DRVOTRK 
7 SLOT 
SLOT 
SLOT 
SLOT 
SLOT 
- SLOT 
RETRYCNT 
SEEKCNT 
BUF 
ENVTEMP 


-EQU 
-EQU 


»EQU 
-EQU 


-EQU 
-EQU 
-EQU 
-EQU 
-EQU 
»EQU 
-EQU 
-EQU 
-EQU 
-EQU 
-EQU 
-EQU 
-EQU 
DRIVE 
DRIVE 
DRIVE 
DRIVE 
DRIVE 
DRIVE 
-EQU 
-EQU 
-EQU 
-EQU 


D20D 
D3 G2 


8B 
GES 


81 
IBSLOT+1 
IBSLOT+2 
IBSLOT+3 
IBSLOT+4 
IBSLOT+6 
IBSLOT+7 
IBSLOT+8 
IBSMOD 
IBSLOT+9 
IBSLOT+@A 
IBSLOT+@B 
CURTRK-7 


IBSLOT+12 
IBSLOT+13 
IBSLOT+1A 
IBSLOT+1E 


? IBSLOT+$1F NOT USED 


ORT RII ak 


* 


~-~-+READADR-~-- 


* 


SOO OOO IOI OOOO ie 


COUNT 
LAST 

CKSUM 
CSSTV 


-EQU 
-EQU 
-EQU 
-EQU 


IBSLOT+14 
IBSLOT+14 
IBSLOT+15 
IBSLOT+16 


(ZERO PAGE AT $398) 


USED ALSO FOR ADDRESS HEADER CKSUM 


‘MUST FIND' COUNT. 


‘ODD BIT' NIBLS. 
CHECKSUM BYTE. 


; FOUR BYTES 


F2SD | ; CHECKSUM, SECTOR, TRACK, AND VOLUME. 
FOOD | 
FSCS 
FOOD | 
FOOD 
FRB | 
FOSS} 
FRB | 
FOB} 


; 
PRAM RRR KIRA EEE EREREK 
3 
? 
: 
; 
‘ 
; 
F2OS . 
? 
? 
; 
‘ 
; 
; 
; 
i 
i 


----WRITE---- 


AND 32-BYTE 


* 
x 
* 
USES ALL NBUFS * 
x 
DATA TABLE 'NIBL' * 

* 

* 


FOO} OOO IOI II IOI IOI OI ior 


FQS8 | 
F228) 
F2OD} 
FRB} 
FRSO | 
FOS | 
F288 | 
F228 | 


CT OOSSCSCSCSCSCSCSCSSCSCSCSC*S PGS 007 GFOUTO 


TOR III III IOC oie 


----READ---- 


USES ALL NBUFS 
USES LAST 54 BYTES 
OF A CODE PAGE FOR 


ee Oe 
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SIGNIFICANT BYTES 
OF DNIBL TABLE. 


IORI OIG GI Ooi 


FOR OTIC RRO KR 
* 

----SEEK---- x 

* 
ORIG doe 


Me Se Mee Nae Be tee te 


TRKCNT -EQU COUNT HALFTRACKS MOVED COUNT. 
PRIOR -EQU IBSLOT+1C 
TRKN -EQU IBSLOT+1D 


? 
ORR III III III II 
x 
----MSWAIT---- x 
x 
OR RRO tok 


. 


See see 


MONTIMEL -EQU CSSTV+2 MOTOR-ON TIME 
MONTIMEH «EQU MONTIMEL+1 COUNTERS. 


’ 
SOI IO III tok 


* 


DEVICE ADDRESS * 
ASSIGNMENTS ¥ 


x 
BOR OI IOI III IOI oe 


Sette 


. 


a 
PHASEOFF -EQU BCOBS 
PHASEON »EQU oCe81 
Q6L -EQU SCBEC 
Q6H -EQU 
Q7L -EQU 
Q7H -EQU 
INTERUPT «EQU 
ENVIRON »EQU 
ONEMEG -EQU 
TWOMEG -EQU 


STEPPER PHASE 
STEPPER PHASE 
Q7L, Q6L=READ 
Q7L, Q6H=SENSE 
Q7H, Q6L=WRITE 
QO7H, Q6H=WRITE 


MeN ae 


FORO ROO IO IO IKK KR 


EQUATES FOR RWTS AND BLOCK 


RRKKKEARKKKKKKK KAKA KKK KA KKK KKK 


7 
? 
’ 
‘ 
G 
‘ 


MOTOROFF -EQU SCVES 
MOTORON . EQU OCB89 
DRVOEN - EQU SCOBA 
DRV1EN .EQU SCOBB 
PHASON -EQU GCS81 
PHSOFF +-EQU OCOD 
TEMP -EQU CSSTV 7 PUT ADDRESS INFO HERE 
CSUM1 -EQU TEMP 

SECT -EQU CSUM1+1 
TRACK -EQU SECT+1 
TRKN1 -EQU TRACK 
VOLUME -EQU TRACK+1 
IBRERR -EQU HRDERRS+3 
IBDERR -EQU HRDERRS+2 
IBWPER + EQU HRDERRS+1 
IBNODRV -EQU HRDERRS 


CORO IIIII OR IOI III III III IOI tok 
x 

READ WRITE A % 
TRACK AND SECTOR * 


x 
RRR KKEKEEKKKKKKRAKKKKEKEKKRKKKKE 


ses 


MeN Ne te Se Me 


REGRWTS LDY #21 RETRY COUNT 
LDX IBSLOT GET SLOT # FOR THIS OPERATION 
STY SEEKCNT ONLY ONE RECALIBRATE PER CALL 
LDA # BOS 
STA O8F 
PHP DETERMINE INTERRUPT STATUS 
PLA 
ROR 
ROR GET INTERRUPT FLAG INTO BIT 7 
ROR 
ROR 
STA 
LDA PRESERVE ENVIRONMENT 
STA 
JSR SET ZERO FLAG IF MOTOR STOPPED 
PHP ; SAVE TEST RESULTS 
LDA IBBUFP ; MOVE OUT POINTER TO BUFFER INTO ZPAGE 
STA BUF 
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IBBUFP+1 
BUF +1 
#DVMOT 
STA MONT IMEH 
LDA IBDRVN ; DETERMINE DRIVE ONE OR TWO 
CMP IOBPDN ; SAME DRIVE USED BEFORE 
STA IOBPDN SAVE IT FOR NEXT TIME 
PHP KEEP RESULTS OF COMPARE 
ROR A ; GET DRIVE NUMBER INTO CARRY 
BD 89C@ LDA MOTORON, X ; TURN ON THE DRIVE 
9201 Bcc DRIVSEL ; BRANCH IF DRIVE 1 SELECTED 
E8 INX SELECT DRIVE 2 
BD 8AC@ DRIVSEL LDA DRVOEN, X 
JSR SET1MEG INSURE ONE MEGAHERTZ OPERATION 
PLP WAS IT SAME DRIVE? 
BEQ OK 
PLP MUST INDICATE DRIVE OFF BY SETTING ZERO FLAG 
LDY #27 DELAY 158 MS BEFORE STEPPING 
DRVWAIT JSR MSWAIT (ON RETURN A=@) 
DEY 
BNE DRVWAIT 
PHP 
LDA IBTRK 


NOW ZERO FLAG SET 
GET DESTINATION TRACK 
LDX IBSLOT RESTORE PROPER X (SLOT*16) 
JSR MYSEEK AND GO TO IT 
NOW AT THE DESIRED TRACK WAS THE MOTOR ON TO START WITH? 
PLP WAS MOTOR ON? 
BNE TRYTRK IF SO, DON'T DELAY, GET IT TODAY! 


Sate ve te 


a 
’ 


MOTOR WAS OFF, WAIT FOR IT TO SPEED UP 


G 
MOTOF LDY #12 WAIT EXACTLY 182 US FOR EACH COUNT 
CONWAIT DEY IN MONTIME 

BNE CONWAIT 

INC MONTIMEL COUNT UP TO 2889 

BNE MOTOF 

INC MONTIMEH 

BMI MOTOF 


FORO IOGRRGOI IIIT OI OI I 
MOTOR SHOULD BE UP TO SPEED 

IF IT STILL LOOKS STOPPED THEN 
THE DRIVE IS NOT PRESENT. 


KKK KKKKKKEKHKKKEKR KK AKA K KR 


’ 
’ 
. 
’ 
, 
’ 
’ 
’ 


JSR CHKDRV IS DRIVE PRESENT? 
BNE TRYTRK YES, CONTINUE 

NODRIVERR LDA #IBNODRV NO, GET TELL EM NO DRIVE 
JMP HNDLERR 


NOW CHECK IF IT IS NOT THE FORMAT DISK COMMAND, 
LOCATE THE CORRECT SECTOR FOR THIS OPERATION 


LDA IBCMD 
BEQ ALLDONE 
CMP #23 
BCS ALLDONE 
ROR A 
BCS TRYTRK2 
LDA ENVIRON 
AND #TWOMEG 7; SHIFT TO HIGH SPEED! 
STA ENVIRON 
JSR PRENIB16 
TRYTRK2 LDY #7F ONLY 127 RETRIES OF ANY KIND 
sTY RETRYCNT 
TRYADR LDX IBSLOT GET SLOT NUM INTO X-REG 
JSR RDADR16 READ NEXT ADDRESS FIELD 
BCC RDRIGHT IF READ IS RIGHT, HURRAH! 
TRYADR2 JSR CHKINT BRANCH TO CHECK FOR INTERRUPTS 
DEC RETRYCNT ANOTHER MISTAKE! ! 
BPL TRYADR WELL, LET IT GO THIS TIME 
DEC SEEKCNT ONLY RECALIBRATE ONCE! 
BNE DRVERR TRIED TO RECALIBRATE A SECOND TIME, ERROR! 
LDA Oar ANOTHER MISTAKE! ! 
BMI TRYADR WELL, LET IT GO THIS TIME 
LDA CURTRK 
PHA SAVE TRACK WE REALLY WANT 
LDA #6D RECALIBRATE ALL OVER AGAIN! ERROR! 
JSR SETTRK PRETEND TO BE ON TRACK 8@ 
LDA 499 
JSR MY SEEK MOVE TO TRACK @¢ 
PLA 
JSR MY SEEK GO TO CORRECT TRACK THIS TIME! 
BCC TRYADR LOOP BACK, TRY AGAIN ON THIS TRACK 


GET COMMAND CODE # 

IF NULL COMMAND, GO HOME TO BED 
COMMAND IN RANGE? 

NO, DO NOTHING! 

SET CARRY=1 FOR READ, @ FOR WRITE 
MUST PRENIBBLIZE FOR WRITE 


HAVE NOW READ AN ADDRESS FPIELD CORRECTLY. 
MAKE SURE THIS IS THE TRACK, SECTOR, AND VOLUME DESIRED. 


DRIGHT LDY TRACK ; ON THE RIGHT TRACK? 
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F@AE| C4 8C CPY CURTRK 

F2B2| F@SE BEQ RTTRK IF SO, GOOD 

F2B2| 

FQB2| RECALIBRATING FROM THIS TRACK 

F2B2| 

F2B2| CURTRK PRESERVE DESTINATION TRACK 
F@B4| 

F@BS | 

F2B6 | A 

F@B7| 28 25F1 SETTRK 
F@BAI 

FOBBI MY SEEK 
F@BE | TRYADR2 
F2Co| RTTRK VOLUME 
FOC2 | IBSMOD 
FoC4 | CORRECTVOL SECT 

FQC6} IBSECT 
FOC8} TRYADR2 
FCA] IBCMD 
F@CC| A 

FgcD| WRIT 

FCF | READ16 
F@D2| TRYADR2 
F@D4 | ENVIRON 
F@DT| #TWOMEG 
Fe@D9| ENVIRON 
FODCI POSTNIB16 
FQDF | IBSLOT 
FSE1| TRYADR2 
FQE3 | ALLDONE 

F@E4| #28 

FQE6 | ALDONE1 
F@E8 | DRVERR #IBDERR 
F@EA| HNDLERR 

FSEB| ALDONE1 IBSTAT 
F@ED| MOTOROFF, X 
FOFS| CHKINT 
FOF3| ENVTEMP 
FOFS| ENVIRON 
FQF8 | 

FOF9 
FOF9 WRITE16 WRITE NYBBLES NOW 

FSFC ALLDONE IF NO ERRORS 

FOFE #IBWPER DISK IS WRITE PROTECTED!! 

F188 HNDLERR TAKEN IF TRUELY WRITE PROTECT ERROR 

F1g2| BNE TRYADR2 OTHERWISE ASSUME AN INTERRUPT MESSED THINGS UP 
F1o4| ; 
F1g41 ; THIS IS THE 'SEEK' ROUTINE 

F104 SEEKS TRACK 'N' IN SLOT #X/$18 
F184 IF DRIVENO IS NEGATIVE, ON DRIVE @ 
F104 IF DRIVENO IS POSITIVE, ON DRIVE 1 
F184 F 
F184| MYSEEK ASL A 

F195] SEEK1 STA TRKN1 
F197) JSR ALLOFF 
P1QA] JSR DRVINDX 
F1@D| LDA DRVOTRK, X 
F1OF| STA CURTRK 
F111] LDA TRKN1 
F113] STA DRVOTRK, X 
F115] GOSEEK JSR SEEK 
F118] ALLOFF LDY #03 

F11Al NXOFF TYA 

F11B] JSR CLRPHASE 
F11E DEY 

P11F BPL NXOFF 
F121) LSR CURTRK DIVIDE BACK NOW 
F123| CLC 

F124| RTS 

F125] 
F125 
F125 
F125| 
F125| 2@ 3EF1 ETTRK JSR DRVINDX j; GET INDEX TO DRIVE NUMBER 
F128| 95 85 STA DRVOTRK, X 

F12A| 68 RTS 

F12B 
F12B KER KKK KKK KAKA RK KKK KAKA EK KK 
F12B 
F12B SUBR TO TELL IF MOTOR IS STOPPED 
F12B 
F12B IF MOTOR IS STOPPED, CONTROLLER'S 
F12B SHIFT REG WILL NOT BE CHANGING. 
F12B 
F12B RETURN Y=@ AND ZERO FLAG SET IF IT IS STOPPED. 
ae te Seee ee SSee eee eee ee eee eee ee 
F12B ; 
F12B CHKDRV LDY #2 INIT LOOP COUNTER 
F12D CHKDRV1 LDA Q6L,X READ THE SHIFT REG 


CO OSSCSCSCSCSCSCSCSCSCSCSCCC*S Paige 0082 TOT 


GET ACTUAL VOLUME HERE 
TELL OPSYS WHAT VOLUME WAS THERE 
CHECK IF THIS IS THE RIGHT SECTOR 


sete te 


NO, TRY ANOTHER SECTOR 

READ OR WRITE? 

THE CARRY WILL TELL 

CARRY WAS SET FOR READ OPERATION, 
CLEARED FOR WRITE 

CARRY SET UPON RETURN IF BAD READ 


SET TWO MEGAHERTZ 

DO PARTIAL POSTNIBBLE CONVERSION 
RESTORE SLOTNUM INTO X 

CHECKSUM ERROR 


NO ERROR 

SKIP OVER NEXT BYTE WITH BIT OPCODE 
BAD DRIVE 

INDICATE AN ERROR 

GIVE HIM ERROR 

TURN IT OFF 

BRANCH TO CHECK FOR INTERRUPTS 
RESTORE ORIGINAL ENVIRONMENT 


SCC Tecra riots 


ASSUME TWO PHASE STEPPER. 

SAVE DESTINATION TRACK {*2) 

TURN ALL PHASES OFF TO BE SURE. 

GET INDEX TO PREVIOUS TRACK FOR CURRENT DRIVE 


Nee ee 


THIS IS WHERE I AM 
AND WHERE I'M GOING TO 


sae 


GO THERE! 

TURN OFF ALL PHASES BEFORE RETURNING 

(SEND PHASE IN ACC.) 

CARRY IS CLEAR, PHASES SHOULD BE TURNED OFF 


Ree ee 


THIS SUBROUTINE SETS THE SLOT DEPENDENT TRACK 
LOCATION 


Up re te te te 
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28 3DF1 CKDRTS DELAY 

48 

68 

DD scce Q6L,X 
CKDRTS 


HAS SHIFT REG CHANGED? 
YES, MOTOR IS MOVING 
NO, DEC RETRY COUNTER 
AND TRY 256 TIMES 
THEN RETURN 


CHKDRV1 


Nese a ee 


CKDRTS 


DRVINDX ; PRESERVE ACC. 
GET SLOT (*$19) /8 


FOR DRIVE @ OR 1 
INTO X FOR INDEX TO TABLE 
RESTORE ACC. 


RRR RAK KK KKK KKK ERK KEKE KKK 


NOTE: FORMATTING ROUTINES 
NOTE INCLUDED FOR SOS 
Latumeen nenad 


RR RIO RIK KIRKE KR KKK KEK KEK 


Rk RK RK RK RK 
* 


READ SUBROUTINE i 


(16-SECTOR FORMAT) * 
x 


REKKKKARKKA KKK KKK RRR KK RK 
k 


READS ENCODED BYTES 
INTO NBUF1 AND NBUF2 


FIRST READS NBUF2 
HIGH TO LOW, 

THEN READS NBUF1 
LOW TO HIGH. 


ee ee Ne Se ee Se Ne Ss 


---- ON ENTRY ---- 


X-REG: SLOTNUM 
TIMES $16. 


READ MODE (Q6L, Q7L 


w--- ON EXIT --~- 


IF NO ERROR: 
A-REG HOLDS SAA. 
X-REG UNCHANGED. 
Y-REG HOLDS $8@. 
CARRY CLEAR. 
--~- CAUTION 


ee Na Ne Me Se Se tne Se Ne Se Fe te Ue te Te te te ee 


OBSERVE 
"NO PAGE CROSS' 
WARNINGS ON 
SOME BRANCHES!! 


---- ASSUMES ~-~- 


1 USEC CYCLE TIME 


* 
* 
* 
x 
* 
* 
* 
* 
* 
* 
* 
x 
* 
* 
* 
* 
* 
CARRY SET IF ERROR * 
* 
* 
* 
x 
* 
* 
* 
* 
* 
* 
* 
*« 
« 
* 
* 
* 
* 
* 


RR RR RO tO KR kkk RK tok 


Sere ra Tee re Taree rae rac yy 


AD 20 READ16 LDY #20 ; ‘MUST FIND' COUNT. 
88 RSYNC DEY IF CAN'T FIND MARKS. 
FO6A BEQ RDERR THEN EXIT WITH CARRY SET 
BD 8cce RD1 LDA Q6L,X READ NIBL. 
19FB BPL RD1 *x** NO PAGE CROSS! *** 
49 DS RSYNC] EOR #2D5 DATA MARK1? 
D@F4 BNE RSYNC LOOP IF NOT. 
EA NOP DELAY BETWEEN NIBLS. 
BD 8ccg RD2 LDA Q6L,X 
19FB BPL RD2 *** NO PAGE CROSS! *** 
co AA CMP #OAA DATA MARK 2? 
DOF 2 BNE RSYNC1 (IF NOT, IS IT DM1?) 
A@ 55 LDY #255 ; INIT NBUF2 INDEX. 
( ADDED NIBL DELAY) 

BA NOP DELAY BETWEEN NIBLS. 
BD 8Ccc@ LDA Q6L,X 
12FB BPL RD3 x** NO PAGE CROSS! *** 
C9 AD CMP #@AD DATA MARK 3? 
DZE6 BNE RSYNC1 ; (IF NOT, IS IT DM1?) 

(CARRY SET IF DM3!) 
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EA DELAY BETWEEN NIBLS. 
EA DELAY BETWEEN NIBLS. 
BD 8cce Q6L,X 
RD4 *** NO PAGE CROSS! *** 
NBUF2,Y¥ STORE BYTES DIRECTLY 
INTERUPT ; POLL INTERRUPT LINE 
IMASK (THIS MAY BE USED TO INVALIDATE POLL) 
GOSERV 
INDEX TO NEXT 
RD4 
(FIRST TIME Y=@) 
Q6L,X ; GET ENCODED BYTES OF NBUF1 
RDSA 
NBUF1,Y 
INTERUPT POLL INTERRUPT LINE 
IMASK (THIS MAY BE USED TO INVALIDATE POLL) 
GOSERV 
#BEA4 ; WITHIN 1 MS OF COMPLETION? 
RD5 


Q6L,X ; NO POLL FROM NOW ON 
RD6 
NBUF1,Y 
FINISH OUT NBUF1 PAGE 
RD6 
RDCKSUM Q6L,X GET CHECKSUM BYTE. 
RDCKSUM 
CKSUM 
RDA6 CHECK BIT SLIP MARKS 


CHECK FOR INTERRUPTS 


HKINT BIT IMASK SHOULD INTERRUPTS BE ALLOWED? 
BPL $912 YES, ALLOW THEM. 
BIT O8F 
BPL $828 

$218 CLI 

$228 RTS 


GOSERV JSR SERVICE GO TO SERVICE INTERRUPT 


RDERR SEC 
RTS 


kkk kk kk RK 


READ ADDRESS FIELD 
SUBROUTINE 
(16-SECTOR FORMAT) 


RK RHR KEKE KKK KK EK KR KICK 


READS VOLUME, TRACK 
AND SECTOR 


~--- ON ENTRY ---- 


XREG: SLOTNUM TIMES $128 


READ MODE (Q6L, Q7L) 


---- ON EXIT ---- 
CARRY SET IF ERROR 


IF NO BRROR: 
A-REG HOLDS $AA. 
Y-REG HOLDS $20. 
X-REG UNCHANGED. 
CARRY CLEAR. 


CSSTV HOLDS CHKSUM, 
SECTOR, TRACK, AND 
VOLUME READ. 


USES TEMPS COUNT, 
LAST, CSUM, AND 
4 BYTES AT CSSTV. 


---- EXPECTS --~~ 
ORIGINAL 19-SECTOR 
NORMAL DENSITY NIBLS 
(4-BIT), ODD BITS, 

THEN EVEN 
---- CAUTION 
OBSERVE 


"NO PAGE CROSS' 
WARNINGS ON 
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SOME BRANCHES! ! 
---- ASSUMES ---- 


1 USEC CYCLE TIME 


* 
* 
* 
* 
* 
x 
* 


eK KKK KAKA KK ER ARK K AK IK 


Ag FC RDADR16 LDY #@FC 
84 95 STY COUNT ‘MUST FIND' COUNT. 
cs RDASYN INY 
D@e4 BNE RDA1 ; LOW ORDER OF COUNT 
E6 95 INC COUNT (2K NIBLS TO FIND 
FQF3 BEQ RDERR ADR MARK, ELSE ERR) 
BD 8cc@ RDA1 LDA Q6L,X ; READ NIBL. 
12FB BPL RDA1 xxx NO PAGE CROSS! *** 
c9 DS RDASN1 CMP #2D5 ADR MARK 1? 
D2FS BNE RDASYN ; (LOOP IF NOT) 
EA NOP ; ADDED NIBL DELAY 
BD 8cc@ RDA2 LDA Q6L,X 
12FB BPL RDA2 ; *** NO PAGE CROSS! *** 
C9 AA CMP HORA ; ADR MARK 2? 
D@F2 BNE RDASN1 (IF NOT, IS IT AM1?) 
A® 3 LDY #03 ; INDEX FOR 4-BYTE READ 
? (ADDED NIBL DELAY) 
BD 8cce RDA3 LDA Q6L,X 
12FB BPL RDA3 ; *** NO PAGE CROSS! *** 
C9 96 CMP #96 ; ADR MARK 3? 
D2E? BNE RDASN1 ; (IF NOT IS IT AM1?) 
; (LEAVES CARRY SET!) 
78 SEI DISABLE INTERRUPT SYSTEM 
Ad 2B LDA #2 INIT CHECKSUM 
85 89 RDAFLD STA CSUM 
BD 8cc@ RDA4 LDA O6L,X READ 'ODD BIT' NIBBL 
BPL RDA4 ; *** NO PAGE CROSS! *** 
ROL A ALIGN ODD BITS, 1' INTO LSB 
STA LAST {SAVE THEM) 
LDA Q6L,X READ 'EVEN BIT' NIBL 
BPL RDA5 **x* NO PAGE CROSS *** 
AND LAST MERGE ODD AND EVEN BITS 
STA CSSTV,Y STORE DATA BYTE 
EOR CSUM 
DEY 
BPL RDAFLD ; LOOP ON 4 DATA BYTES. 
TAY IF FINAL CHECKSUM 
BNE RDERR ; NONZERO, THEN ERROR 
BD 8CC@ LDA Q6L,X FIRST BIT SLIP NIBBL 
12FB BPL RDA6 x** NO PAGE CROSS! *** 
C9 DE CMP #2DE 
D@AD BNE RDERR ERROR IF NONMATCH 
EA NOP ; DELAY 
BD 8cc@ LDA Q6L,X ; SECOND BIT-SLIP NIBL 
BPL RDA? ; *** NO PAGE CROSS! *** 
CMP HORA 
BNE RDERR ERROR IF NOMATCH 
RDEXIT CLC CLEAR CARRY ON 
WEXIT RTS ; NORMAL READ EXITS. 


RARER RRR RA RRR KKK kh 
* 


WRITE SUBR * 
(16-SECTOR FORMAT) * 


x 
a KKAKKKKKKKKKKKKKAKK KHAKI 


* 


WRITES DATA FROM 
NBUF1 AND NBUF2 


FIRST NBUF2, 
HIGH TO LOW. 
THEN NBUF1, 
LOW TO HIGH 
---- ON ENTRY ---- 
X-REG SLOTNUM 
TIMES $12 
---- ON EXIT ----~ 


CARRY SET IF ERROR. 
(W PROT VIOLATION) 


IF NO ERROR: 
A-REG UNCERTAIN. 
X-REG UNCHANGED. 


Y-REG HOLDS $9¢,. 
CARRY CLEAR. 


Fag 085 F077 


ee ee HH HHH Re EE 
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F216| : 
F216} ---- ASSUMES ---- 


* 
* 
F216} * 
F216} 1 USEC CYCLE TIME * 
F216] * 
F216| ree ER RESES SESE SERRE ESS EEG 
F216! 

F216| 38 RITE16 SEC 

F217| B8 CLV 

F218 

F218| BD 8Dce 

F21B| BD 8EC@ 

F21E| 

F228] 

F222] 

F225 | 

F228 

F22A{ 

F22BI 

F22CI 

F22DI 

F22E/ 

F22F | WNIBL7 
F232] 

F233 WSYNC 
F235] #2D5 
F237] WNIBLY 
F23A4 #OBA 
F23CI WNIBL9 
F23F] #@AD 
F241} WNIBL9 
F244] #55 
F246] 

F247] 

F248] 

F249] VRYFRST 
F24B} WINTRPT INTERUPT 
F24B IMASK 
F25@ 
F251 SERVICE 
F253 VRYFRST WRTFRST 
F255 WRTFRST NBUF2, Y 
F258] Q6H,X 
F25B\ Q6L,X 
F25E] 
F25F{ WINTRET 
F261 
F262 WMIDLE 
F264 WNTRPT1 INTERUPT 
F267 WMIDLE IMASK 
F269 
F26A WDATA2 
F26CI SERVICE 
F26E] WDATA2 

F26F| B9 @@@2 NBUF1, Y 
F272| 9D 8DCce Q6H,X 

F275} BD 8CCo Q6L, X 

F278] 424 

F2TAI WNTRPT1 
F27C] 

F27DI 

F27E] WDATA3 

F27F] 

F282) 

F281} 

F282) NBUF1,Y 
F285} Q6H,X 

F288] Q6L,X 

F28BI CKSUM 

F28DI 

F28E| WDATA3 
F292} WRCKSUM 
F292 | WRCKSUM WNIBLT 
F295 | 

F296 | 

F297| WRBITSLMK BITSLIPMK, Y 
F29A| WNIBL 

F29D| 

F29E| #4 

F2A8| WRBITSLMK 
F2A2| 

F2A3| NOWRITE Q7L,X 

F2A6| Q6L,X 

F2A9| 

F2AA| 7 

F2AA| SERVICE SEV 

F2AD| NOWRITE 
F2BO| @8F 

F2B2 | $910 

F2B4| IMASK 


CO OSSCSCSCSCSCSCSCSCSCSCCC*S Pg 0086 F017 


ANTICIPATE WPROT ERR. 
TO INDICATE WRITE PROTECT ERROR INSTEAD OF 
INTERRUPT 


See se 


SENSE WPROT FLAG. 

BRANCH IF WRITE PROTECTED 
SYNC DATA. 

(5) GOTO WRITE MODE 

(4) 

(2) FOR FIVE NIBLS. 

(2) 

(4) 

(3) 

(4) EXACT TIMING 

(3) 

(13,9,6) WRITE SYNC 

(2) 

(2*) MUST NOT CROSS PAGE! 
(2) 1ST DATA MARK 

(15,9, 6) 

(2) 2ND DATA MARK 

(15,9, 6) 

(2) 3RD DATA MARK 

(15, 9,6) 

(2) NBUF2 INDEX 

(2) FOR TIMING 

(2) 

(2) 

(3) BRANCH ALWAYS 

(4) POLL INTERRUPT LINE 

(3) 

(2) 

(2) BRANCH IF INTERRUPT HAS OCCURED 
(3) FOR TIMING. 

(4) 

(5) STORE ENCODED BYTE 

(4) TIME MUST = 32 US PER BYTE! 
(2) 

(3) (2 IF BRANCH NOT TAKEN) 
(2) INSURE NO INTERRUPT THIS BYTE 
(3) BRANCH ALWAYS. 

(4) POLL INTERRUPT LINE 

(3) 

(2) 

(3) BRANCH IF NO INTERRUPT 
GO SERVICE INTERRUPT. 

(2) 

(4) 

(5) STORE ENCODED BYTE 

(4) 

(2) WITHIN 1 MS OF COMPLETION? 
(3) (2) NO KEEP WRITTING AND POLLING. 
(2) 

(2) 

(2) 

(2) 

(4) 

(3) 

(4) WRITE LAST OF ENCODED BYTES 
(5) WITHOUT POLLING INTERRUPTS. 
(4) 

(3) NORMALLY FOR TIMING 

(2) 

(3) (2) 

(3) BRANCH ALWAYS 

(13,9,6) GO WRITE CHECK SUM!! 
(3) 

(4) 

(4) LOAD BIT SLIP MARK 
(6,9, 6) 

(2) 

(2) 

(2) (3) 

(2) 

OUT OF WRITE MODE. 

TO READ MODE. 

RETURN FROM WRITE. 


eet Tr Ti TT ti rt ri ri ti rt ei Ti rt tio ri ti ri ti tan i rei aie re Te Ti i iri i i i Ti re Til i eT ei ee ee ee eer 


SET VFLAG TO INDICATE INTERRUPT 
TAKE IT OUT OF WRITE MODE! 
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F2B6| C6 8F $212 DEC 
F2B8| 58 CLI # COULD NOT HAVE GOT HERE WITHOUT CLI OK 
F2B9| 62 RTS 
F2BA| 
F2BAI 
F2BAI 
F2BA| 
F2BA[ 
F2BA| 
F2BAI 
F2BA| 
F2BAI 
F2BAI ; 
F2BAI WNIBL9Y cLc 4 9 CYCLES, THEN WRITE 
F2BBI WNIBL7? PHA 7 CYCLES, THEN WRITE 
F2BC| PLA ; 
F2BD} 9D 8pCc@ WNIBL STA Q6H,X ; NIBL WRITE SUB 
F2C2} 1D 8cCce ORA Q6L,X CLOBBERS ACC. NOT CARRY 
F2C3} 6@ RTS 
F2C4} - 
F2C4] ol 
F2C4} - 
F2C4} ? 
F2c4] . 
F2C4} . 
F2C4| 7 
F2c4| Hi 
F2C4] . 
F2c4| ; 
F2c4| ; 
F2c4] = 
F2C4| o 
F2Cc4!} ir 
F2C4 7 
F2C4 7 ---- ON ENTRY ---- 
; 
r 
; 
P 


kkk kak Ok RRS aa tote kek kok 


7-BIT NIBL WRITE SUBRS 


x 
x 
x 
A-REG OR'D PRIOR EXIT - 
CARRY CLEARED is 

x 

* 


FOR IOI RO koko 


e Se Se se te se ts te te te 


ak kk kk RAK RK aK 
* 


PRENIBILIZE SUBR i 
(16-SECTOR FORMAT) * 


x 
KKK EK K KKK EK KKK KKK 
od 


CONVERTS 256 BYTES OF 
USER DATA IN (BUF) INTO 
ENCODED BYTES TO BE 
WRITTEN DIRECTLY TO DISK 
ENCODED CHECK SUM IN 
ZERO PAGE 'CKSUM' 


F2C4 
F2C4 
F2C4 
F2c4 
F2Cc4j 
F2c4 
F2CA4} 
F2Cc4 
F2C4j 
F2C4| 
F2Cc4| 
F2C4j 
F2c4 RENIB16 LDX #B2 START NBUF2 INDEX. 

F2C6 LDY #BD START USER BUF INDEX. 

F2c8 PRENIB1 DEY NEXT USER BYTE 

F2cg LDA {BUF),¥ 

F2CB LSR A SHIFT TWO BITS OF 

F2CC} ROL NBUF2-1,X CURRENT USER BYTE 

F2CF| LSR A ; INTO CURRENT NBUF2 

F2D8| ROL NBUF2-1,X , BYTE. 

F2D3| STA NBUF1+1,¥Y (6 BITS LEFT). 

F2D6| INX ; FROM @ TO $55 

F2D7| CPX #56 

F2D9| BCC PRENIB1 ; BR IF NO WRAPAROUND 

F2DBi LDX #00 ; RESET NBUF2 INDEX 

F2DD]| TYA ; USER BUF INDEX 

F2DE] BNE PRENIB1 ; (DONE IF ZERO) 

F2E| LDY #56 ; (ACC=@ FOR CHECK SUM) 

F2E2| PRENIB3 NBUF2~2,Y COMBINE WITH PREVIOUS 

F2E5| PRENIB2 #O3F STRIP GARBAGE BITS 

F257} TO FORM RUNNING CHECK SUM 

F2E8 | LDA NIBL,X GET ENCODED EQUIV. 

F2EB| STA NBUF'2-1,¥ REPLACE PREVIOUS 

F2EE| LDA NBUF2-2,Y RESTORE ACTUAL PREVIOUS 

F2F1 | DEY 

F2F2| BNE PRENIB3 LOOP UNTIL ALL OF NBUF2 IS CONVERTED. 
F2F4| AND #3F 

F2F6| 59 2122 PRENIB4 EOR NBUF1+1,Y ; NOW DO THE SAME FOR 

F2F9| AA TAX ; NIBBLE BUFFER 1 

F2FA{ BD 55F3 LDA NIBL,X ; TO DO ANY BACK TRACKING (NBUF1-1) 
F2FD| 99 @@@2 STA NBUF1,Y 

F300| B9 182 LDA NBUF1+1,Y RECOVER THAT WHICH IS NOW ‘PREVIOUS' 
F3@3| C8 INY 

F304| D@Fre BNE PRENIB4 

F3@6| AA TAX USE LAST AS CHECK SUM 

F307| BD 55F3 LDA NIBL,X 

F3QAl 85 96 STA CKSUM 

F38C| 4C 4CF3 JMP SET1MEG ALL DONE. 

F32F | 

F3QF | FORTIER RK RRR RR RR KK 

F30F | 

F3QF | POSTNIBLIZE SUBR 

F3QF | 16-SECTOR FORMAT 

F39F | = 


F3@F | KAKA RK RE KKK EKEKKEKKEER 


C= PGS 0087 FOTO 


TO 256 BYTES OF USER 
DATA. 


* 

* 

* 

* 

* 

* 

* 

* 

* 

BUF IS 2-BYTE POINTER * 
* 

* 

* 

A-REG CHECK SUM. * 
X-REG UNCERTAIN * 
Y-REG HOLDS 9. * 
CARRY SET. i. 
* 

* 


kkk kkk kak kK KEK KA KKKKKKAKR KKK 
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fi 
POSTNIB16 
#55 
#20 
PNIBL1 NBUF2, ¥ 
DNIBL, X 
SETLMEG 
NBUF2, Y 


FIRST CONVERT TO 6 BIT NIBBLES 
INIT CHECK SUM 
GET ENCODED BYTE 


te sete 


SET 1 MHZ 
REPLACE WITH 6 BIT EQUIV. 


PRENIB1 LOOP UNTIL DONE WITH NIBBLE BUFFER 2 
NOW Y= 


DO THE SAME WITH 


Mase se 


PNIBL2 NBUF1,Y 
DNIBL, X 
NBUF1,Y NIBBLE BUFFER 1 


DO ALL 256 BYTES 


nate 


PNIBL2 
CKSUM 
DNIBL, X 
POSTERR 
#56 


MAKE SURE CHECK SUM MATCHES 
BETTER BE 2ERO 

BRANCH IF IT IS 

INIT NBUF2 INDEX 

NBUF IDX $55 TO $a 
WRAPAROUND IF NEG 


Me te ea see 


POST1 
NBUF1, Y 
NBUF2, X 
A 
LSR NBUF2, X 
ROL A 
STA (BUF), ¥ 
INY 
BNE POST2 
cL 
POSTERR .EQU * 
AD DFFF SET1MEG LDA ENVIRON 
ZI Bo ORA #ONEMEG SET TO ONE MEGAHERTZ CLOCK RATE 
8D DFFF STA ENVIRON 
62 SEV RTS (SEV USED TO SET VFLAG) 


SHIFT 2 BITS FROM 
CURRENT NBUF2 NIBL 
CURRENT NBUOF1 
NIBL. 

BYTE OF USER DATA 
NEXT USER BYTE 


Me te se te tee 


GOOD DATA 


’ 
FORO RIO RK RRR RR KKK KE IOK 
x 


6-BIT TO 7-BIT * 


NIBL CONVERSION TABLE * 
x 


CORIO KI KO kk 
x 


ONE PAIR OF ADJACENT 
ZEROES OR WITH NO 

ADJACENT ONES (EXCEPT 
B7) ARE EXCLUDED. 


OI IOI OIRO IOI III IOI I 


‘ 
’ CODES WITH MORE THAN 
’ 
' 


NIBL -BYTE 96,97, 9A, 9B, 9D, 9E, 9F, @A6,@A7, AB, SAC, AD, OAL, GAF, OB2, 9B3,2B4,2B5 


-BYTE @B6,@B7,@B9, OBA, OBB, OBC, OBD, OBE, OBE, CCB, SCD, SCE, SCF, @D3, @D6, D7 


-BYTE @D9, DA, DB, @DC, SDD, ODE, ODF, GE5, E6, GE7, ZE9, SEA, ZEB, EC, ZED, GEE 


-BYTE @EF, OF2,@F3,@F4,@F5,0F6,0F7,OF9, OFA, OFB, OFC, OFD, OFE, OFF 


DKK KKK KK RRA KKK EK KEKE EK 


7-BIT TO 6-BIT 
‘DENIBLIZE' TABL 
(16-SECTOR FORMAT) 


VALID CODES 
$96 TO SFF ONLY. 


CODES WITH MORE THAN 
ONE PAIR OF ADJACENT 
ZEROES OR WITH NO 
ADJACENT ONES (EXCEPT 
BIT 7) ARE EXCLUDED 


KKK KARI KANAWHA RAKKKE KKK 


+ OF OF OO OF OO OO OO 


DNIBL -EQU REGRWTS+30¢ 
-BYTE 01,08, 01 
9C @4 BS -BYTE 98,99,22,23, 9C,@4, 85,96, CAD, @A1, QA2, @A3, GA4, GAS, 7,08, GAB 
A3 A4 AS 


@B @C SD »BYTE GA9, GAA, 09, 2A, OB, OC, OD, GBS, OB1, GE, GF, 18, 11,12,13,8B8,14,15 
12 11 12 


1A »BYTE 16,17,18,19,1A 


Fag 088 F077 
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C6 BITSLIPMK .BYTE DE, @AA, @EB, @FF,@C4,@C5,@C6, C7, C8, @C9, GCA, 1B, @CC,1C,1D,1E 
«BYTE  @D@,@D1,@2D2,1F,@D4,@D5, 2, 21,8D8, 22, 23,24, 25,26, 27,28, GES, GE1 
-BYTE  @E2,@F3,@E4,29,2A, 2B,@E8,2C, 2D, 2E, 2F, 30,31, 32, @F@, OF1, 33,34 
-BYTE  35,36,37,38,@F8, 39, 3A, 3B, 3C, 3D, 3E, 3F 


RAKKKKKAKAKEKANAKK KKK KI 
* 

FAST SEEK SUBROUTINE * 

* 
RKKKKERKEKKKKAKKKRAKK KKK KKK 
* 


---- ON ENTRY ---- 


X-REG HOLDS SLOTNUM 
TIMES $18 


A-REG HOLDS DESIRED 
HALFTRACK. 


CURTRK HOLDS DESIRED 
HALFTRACK. 


---- ON EXIT --~- 


A~-REG UNCERTAIN. 
Y-REG UNCERTAIN. 
X-REG UNDISTURBED. 


CURTRK AND TRKN HOLD 
FINAL HALFTRACK. 


PRIOR HOLDS PRIOR 
HALFTRACK IF SEEK 
WAS REQUIRED. 


MONTIMEL AND MONTIMEH 
ARE INCREMENTED BY 
THE NUMBER OF 
128 USEC QUANTUMS 
REQUIRED BY SEEK 
FOR MOTOR ON TIME 
OVERLAP. 


~~- VARIABLES USED --- 


CURTRK, TRKN, COUNT, 
PRIOR, SLOTTEMP 
MONTIMEL, MONTIMEH 


’ 
’ 
‘ 
’ 
. 
‘ 
. 
. 
’ 
. 
e 
. 
’ 
’ 
: 
, 
. 
. 
’ 
: 
. 
. 
’ 
. 
‘ 
’ 
’ 
e 
’ 
’ 
’ 
. 
’ 
‘ 
‘ 
’ 
’ 
, 
‘ 
: 
‘ 
’ 
’ 
’ 


* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
x 
* 
* 
* 
x 
* 
x 
* 
* 
* 
x 
* 
* 
* 
* 
« 
* 
* 
* 
* 


KKK KKKKAKKKKAKARARKKKK KK 


wees 
ag 
ik 
aw 


STA TRKN ; SAVE TARGET TRACK 
CMP CURTRK ; ON DESIRED TRACK? 
BEQ SETPHASE ; YES, ENERGIZE PHASE AND RETURN 
LDA Lie) 
STA TRKCNT HALFTRACK COUNT. 
LDA CURTRK SAVE CURTRK FOR 
STA PRIOR ; DELAYED TURN OFF. 
SEC 
SBC TRKN DELTA-TRACKS. 
BEQ SEEKEND BR IF CURTRK=DESTINATION 
BCS out (MOVE OUT, NOT IN) 
EOR #OFF + CALC TRKS TO GO. 
INC CURTRK ; DECR CURRENT TRACK (OUT) 
BCC MINTST (ALWAYS TAKEN) . 
OUT ADC #OFE CALC TRACKS TO GO. 
DEC CURTRK DECR CURRENT TRACK (OUT) 
MINTST CMP TRKCNT 
BCC MAXTST 7 AND 'TRKS MOVED' 
LDA TRKCNT 
MAXTST CMP #09 
BCS STEP2 IF TRKCNT>$@8 LEAVE Y ALONE (Y=$@8) 
STEP TAY ELSE SET ACCELERATION INDEX IN Y 
SEC 
STEP2 JSR SETPHASE 
LDA ONTABLE, Y 
JSR MSWAIT 
LDA PRIOR 
CLC 
JSR CLRPHASE 
LDA OFFTABLE, Y 
JSR MSWAIT 
INC TRKCNT 


CO SOSCSSCSCSCSCSCSCSCSCSCSCSCCC*S Pg 0089 GF 017 


FOR 'ONTIME' 
(1@@ USEC INTERVALS) 


FOR PHASE OFF 

TURN OFF PRIOR PHASE 
THEN WAIT 'OFFTIME' 
(1@@ USEC INTERVALS) 
‘TRACKS MOVED' COUNT. 
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BNE SEEK2 
SEEKEND JSR MSWAIT 
CLC 
SETPHASE LDA CURTRK 
CLRPHASE AND #23 
ROL A 
ORA IBSLOT 
TAX 
LDA PHASEOFF , X ; TURN ON/OFF ONE PHASE 
LDX IBSLOT RESTORE X-REG 
SEEKRTS RTS ; AND RETURN 


(ALWAYS TAKEN) 

SETTLE 25 MSEC 

SET FOR PHASE OFF 

GET CURRENT TRACK 

MASK FOR 1 AND 4 PHASES 
DOUBLE FOR PHASE ON/OFF INDEX 


ete te Se ee 


KKK KKK KKM KK KKKKRKKEKRKK IK 
* 

MSWAIT SUBROUTINE x 

* 

RnR KR KKK RAK KKK KEK RK IK 
* 


DELAYS A SPECIFIED 
NUMBER OF 192 USEC 
INTERVALS FOR MOTOR 
ON TIMING 


Sea ae te tr te Me 8a tee 


---~- ON EXIT 


A-REG HOLDS $20 
X-REG HOLDS $@@ 
Y-REG UNCHANGED 
CARRY SET 


MONTIMEL, MONTIMEH 
ARE INCREMENTED ONCE 
PER 12@ USEC INTERVAL 
FOR MOTOR ON TIMING 

---~ ASSUMES 


1 USEC CYCLE TIME 


sO OO Oe OO OO OO OO 


KKK RAK KKK KKK IKK KAKAEK KK KK 


Sree re ee ee ree Seren Tee Tae ae Sart 


MSWAIT LDX #11 
MSW1 DEX ; DELAY 86 USEC 
BNE MSW1 
INC MONT IMEL 
BNE MSW2 DOUBLE BYTE INCREMENT 
INC MONT IMEH 
SEC 
SBC #01 DONE IN INTERVALS 
BNE MSWAIT (A-REG COUNTS) 
RTS 


RRR KEK K KK KKM KA KARR EREK EK 


* 
PHASE ON-, OFF-TIME i 
TABLES IN 180-USEC * 
INTERVALS. (SEEK) ‘3 
* 

* 


RAKE RR KKK KKK ERR KR KKK 


28 24 26 1E 1D ONTABLE -BYTE @1,38,28,24,28,1E,1D,1C,1¢C 


26 22 1F 1E 1D OFFTABLE .BYTE 18,2C,26,22,1F,1E,1D,1C,1C 


BLOCKIO STX IBTRK 
LDY #05 
PHA 
TRKSEC ASL A 
ROL IBTRK 
DEY 
BNE TRKSEC 
PLA 
AND #27 
TAY 
LDA SECTABL, Y 
STA IBSECT 
JSR REGRWTS 
BCS QUIT 
INC IBBUFP+1 
INC IBSECT 
INC IBSECT 
JSR REGRWTS 
DEC IBBUFP+1 
QUIT LDA IBSTAT 
RTS 


@4 28 SC B1 OS B9 SECTABL -BYTE 08,04, 08,8C, 1,85, 89, OD 


DOI III III II IIIT 


CSC‘ PGS 0080-7 O77O 
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JOYSTICK READ ROUTINE 


REKKKRKKAKAKRKAKRKR KAKA KKKKEKKEKKEK KE 


ENTRY ACC= COUNT DOWN HIGH * 
X&Y= DON'T CARE 


EXIT ACC= TIMER HIGH BYTE 
Y= TIMER LOW BYTE 
CARRY CLEAR 


IF CARRY SET, ROUTINE 
WAS INTERRUPTED & 
ACC & Y ARE INVALID 


RIK KKK AKRIKK EK AREER EE 


+ eH OF 


FFD9 TIMLATCH -EQU OFFD9 
FFD8 TIMERLL -EQU SFFD8 
FFD9 TIMER1H -EQU OFFD9 
COE66 JOYRDY -EQU OCOEE 


F4A8 ANALOG -EQU z CARRY SHOULD BE SET! 

8D D9FF STA TIMLATCH START THE TIMER! 

AD EFFF ANLOG1 LDA INTERUPT 

2D 66C8 AND JOYRDY 
BMI ANLOG1 
LDA JOYRDY 
BMI GOODTIME 
CLC 
LDA TIMER1LH 
LDY TIMERIL 
BPL GOODTIME ; TIME WAS VALID! 
LDA TIMER1H HI BYTE CHANGED 

GOODTIME RTS 


WAIT FOR ONE OR THE OTHER TO GO 


WAS IT REALLY THE JOPYSTICK? 
NOPE, WHAT TIME IS IT? 
TIME'S A SLIP SLIDIN AWAY 
NOW, WHAT TIME IS IT? 


AB - Absolute LB - Label UD - Undefined 
RF - Ref DF - Def PR - Proc 
PB ~ Public PV - Private CS ~ Consts 


ALDONE1 FEB ALLDONE FE3 
BITSLIPM F3CS BLOCKIO F479 
CHKINT F1AA CKDRTS F13D 
CORRECTV F2c4 COUNT @O95 
CURTRK DBBEC DISKIO ss=- 
DRVERR FZE8 DRVINDX F13E 
DVMOT SPES ENVIRON FFDF 
GOODTIME F4C4 GOSEEK F115 
IBBUFP 285 IBCMD 2287 
IBRERR OD8B3 IBSECT OBB4 
IBTRK WB83 IBWPER ©9081 
JOYRDY CBEe6 LAST 295 
MONTIMEL @B99 MOTOF FQ52 
MSW2 F461 MSWAIT F456 
NIBL F355 NODRIVER FQ64 
OK F248 ONEMEG OOEB 


ALLOFF ANALOG ANLOG1 
BUF CHKDRV CHKDRV1 
CKSUM CLRPHASE CONWAIT 
CSSTV CSUM CSUM1 
DNIBL DRIVSEL DRV1EN 
DRVOEN DRVOTRK DRVWAIT 
ENVTEMP GOCAL GOCAL1 
GOSERV HNDLERR HRDERRS 
IBDERR IBDRVN IBNODRV 
IBSLOT TBSMOD IBSTAT 
IMASK INTERUPT IOBPDN 
MAXTST MINTST MONT IMEH 
MOTOROFF MOTORON MSW1 
MYSEEK NBUF1 NBUF2 
NOWRITE NXOFF OFF TABLE 
ONTABLE our PHASEOFF 


POST1 F336 POST2 F338 
PRENIB16 F2c4 PRENIB2 F2ES 
Q6H C@8D Q6L CBBC 
RD1 F14D RD2 F157 
RDSA F181 RD6 F195 
RDA4 F1E? 


POSTERR POSTNIBI PRENIB1 
PRENIB3 B PRENIB4 PRIOR 
Q7H Q7L QUIT 
RD3 RD4 RDS 
RDA1 RDA2 RDA3 
RDA6 RDA? RDADR16 
RDASYN RDCKSUM RDERR 
READ16 REGRWTS RETRYCNT 
RTTRK SECT SECTABL 
SEEK2 SEEKCNT SEEKEND 
SET1MEG SETPHASE SETTRK 
STEP2 TEMP TIMER1H 
TRACK TRKCNT TRKN 
TRYADR TRYADR2 TRYTRK 
VOLUME VRYFRST WDATA2 
WINTRPT WMIDLE WNIBL 
WNTRPT1 WRBITSLM WRCKSUM 
WRITE16 WRIFRST 


RDAS P1EF 
RDAFLD F1ES RDASN1 F1c9 


RDEXIT F214 RDRIGHT F2AC 


RSYNC F14A RSYNC1 F152 
SEEK FASS 


SEEKRTS F455 


I 
| 
| 
| 
| SEEK1 F1g5 
| SERVICE F2AA 
SEV F354 | STEP F429 
TIMER1L FFD8 | TIMLATCH FFD9 
TRKN1 BBI9 | 
TRYTRK2 FQTF | 
WDATA3 F27E | 
WNIBL? F2BB | 
WRIT FOF9 | 


TRKSEC F47E 
TWOMEG OQTF 
WEXIT F215 
WNIBL9 F2BA 
WRIT F228 


I 
| 
| 
| 
| 
{ 
| 
| 
| 
| 
| 
l 
l 
| 
PHASEON C281 PHASON CG81 | PHSOFF PNIBL1 PNIBL2 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
l 
| 
\ 
| 
| 
| 


Assembly complete: 1976 lines 
i) Errors flagged on this Assembly 
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ak 

kik kk kkk 

aka 

kkk kkk 

ak 

KKK KK 

KERR KEKE EK KK KEK KKKKKKKEKKKKKKKKKEK 
KR RIKI KKK KIKI KR IKK KK IKK 


kaka KKK 
* 


KAKKAKKK KKK 


ray 


Ka 

kkkK 

* 

Rk RK KR KE 
RAKE K 

RRR RK 

* 

kaKKK KK KKK 

x 

KEK RK KEK KK KE KKK KKAKKKKKKKK KK KKK 
HORII KOKO IOI TOK KOTTKE TOR TKR IKK KI IK IK KK KK IORI KK RK KIM ERK KKK KKK EK KK KK KEKE K 
FORO IO 
REKKKKKEKKKKRKEK 
kk kk KEK 
kaka 

kkk KKK 

RRR RK 

KKK 

AR eK Ok 

xk 

kkk RK 

Rk KK 
KRAKKAKKKKK KKK 
* 

Ak RK ik 


we 


he 
NROWN UBP BEN 


RIO IOI OOO III I iO tok ok 


Rk 


kkk 


ae 


kkk 


3 
7 
6 
6 
2 
9 
1 
2 
1 
3 
5 
3 
1 
4 


Minimum frequency 
Maximum frequency 


Average frequency 
Unused opcodes: 
BRK BVS CLD RTI SED TSX 


Program opcode usage: 8&7 % 
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ROM 
Diagnostics 


David T. Craig 


736 Edgewater 
Wichita, Kansas 67230 


000000000000 00 0000 0 0 0 0 


Zz 
ze 
Zz 
Zz 
ze 
Lo 
Zz 
0 
gE 
0 
ze 
0 
ze 
oO 
Zz 
io 
ze 
z 
ge 
ze 
oO 
zz 
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 CSSEEECK CECE KE Eee Re EeSeKe Kee Eee KEe KEKE KEK ECE EE EEK 
@ APPLE /// ROM ~ DIAGNOSTIC ROUTINES 


i COPYRIGHT 1979 BY APPLE COMPUTER, INC. 
USES dekh hehe eee Med ee deck eed eK dk eee ddd deed ddd ded ddEcE 


- ABSOLUTE 
-PROC SARATESTS 


HR RK RK KK KK KR RHR RAK KR RRR RKRRKREKK IKKE KEKE REKKKKKKAKK KA KKK KKK 


SARA DIAGNOSTIC TEST ROUTINES | | f 
DECEMBER 18,1979 W [ 


BY a 
W. BROEDNER & R. LASHLEY 


COPYRIGHT 1979 BY APPLE COMPUTER, INC. 


-EQU 

-EQU 

-EQU 

-EQU ZRPG1+88 

-EQU 2RPG1+89 

-EQU 2RPG1+@A 

-EQU 

-EQU 

»EQU 
BLOCKIO -EQU 
cv -EQU 
STK@ -EQU 
IBNK -EQU 14@@+PTRHI 
PHPR -EQU 1828+ZRPG1 
KYBD -EQU BCLBS 
KEYBD -EQU BCHBE 
KBDSTRB »EQU GCDO1S 
PDLEN -EQU GCZ58 
ADRS -EQU OCB47 
GRMD -EQU OCBSS 
TXTMD -EQU @CG51 
ADTO -EQU SCHES 
DISKOFF -EQU SCODB 
ACIAST -EQU OCOF1 
ACIACM -EQU OCOF 2 
ACIACN + EQU SCOF3 
SLT1 -EQU BC18B 
SLT2 -EQU OC2BS 
SLT3 -EQU BC3BO 
SLT4 -EQU DCABS 
EXPROM -EQU OCFFF 
ZPREG -EQU OF FDS 
SYSD1 -EQU OFFDF 
SYSD2 -EQU OFFD2 
SYSD3 -EQU @FFD3 
SYSE@ -EQU OPPES 
BNKSW -EQU OFFEF 
SYSE2 -EQU OFFE2 
SYSE3 -EQU OFFE3 
cour -EQU @FC25 
CROUT1 -EQU SFDS7 
KEYIN -EQU OFDOF 
SETCVH -EQU @FBC7 
CLDSTRT -EQU GF DIB 
SETUP -EQU @FD9D 
MONITOR -EQU OF 981 

ORG OF 4C5 

B2 BA B3 18 @@ RAMTBL -BYTE 08, 2B1,9B2,9BA, 9B9,18,20,13 


CHPG -EQU x 
-ASCII "RA" 
-BYTE gcd 
-ASCII "RO" 
-BYTE gCD 
-ASCII "vi" 
BYTE gC1 
-ASCII "ACI" 
-BYTE eCl 
-ASCII “A/" 
-BYTE aCc4 
41 47 4B 4F 53 -ASCII "DIAGNOSTI" 


BYTE @C3 
-ASCII "Zz" 
-BYTE 2DB 
-ASCIT “RETR" 
-BYTE OD9 


SETUP SYSTEM 


a 
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#52+ROM TURN OFF SCREEN, SET 2MHZ SPEED 
SYSD1 AND RUN OFF ROM 
#20 SET BANK SWITCH TO ZERO 
STX SYSE@ 
STX BNKSW 
STX ZPREG AND SET ZERO PAGE SAME 
DEX 
SYSD2 PROGRAM DDR'S 
SYSD3 
TXS 
INX 
LDA #OF 
STA SYSE3 
LDA #3F 
STA SYSE2 
LDY #2E 
LDA DISKOFF, Y 
DEY 
DEY 
BPL DISK1 
LDA KEYBD 
AND #24 
BNE NXBYT 
JMP RECON 


VERIFY ZERO PAGE 


NXBYT LDA #21 ; ROTATE A 1 THROUGH 
NXBIT STA ZRPG,X EACH BIT IN THE @ PG 
CMP ZRPG,X TO COMPLETELY TEST 
NOGOOD BNE NOGOOD THE PAGE. HANG IF NOGOOD. 
ASL A TRY NEXT BIT OF BYTE 
BNE NXBIT UNTIL BYTE IS ZERO. 
INX CONTINUE UNTIL PAGE 
BNE NXBYT IS DONE. 
TXA PUSH A DIFFERENT 
PHA BYTE ONTO THE 
INX ; STACK UNTIL ALL 
BNE CNTWR STCK BYTES ARE FULL. 
DEX THEN PULL THEM 
STX PTRLO ; OFF AND COMPARE TO 
PLA ; THE COUNTER GOING 
CMP PTRLO , BACKWARDS. HANG IF 
BNE NOGOOD ; THEY DON'T AGREE. 
DEC PTRLO GET NEXT COUNTER BYTE 
BNE PULBT CONTINUE UNTIL STACK 
PLA ; IS DONE. TEST LAST BYTE 
BNE NOGOOD AGAINST ZERO, 


SIZE IN MEMORY 


LDX #28 
NOMEM STA ZRPG1, X 


ZERO THE BYTES USED TO DISPLAY 
THE BAD RAM LOCATIONS 

EACH BYTE= A CAS LINE 

ON THE SARA BOARD. 

STARTING AT PAGE 2 

TEST THE LAST BYTE 

IN EACH MEM PAGE TO 

SEE IF THE CHIPS ARE 

THERE.. (AVOID @ & STK PAGES) 
CAN THE BYTE BE O'D? 


NOMEM 

#02 

PTRHI 

40D 

#OFF 

(PTRLO}, Y 

(PTRLO), Y 

NMEM2 

RAM ; NO, FIND WHICH CAS IT IS. 

ZRPG1,X SET CORRES. BYTE TO $FF 

PTRHI , RESTORE X REGISTER 

¢ AND INCREMENT TO NEXT 

#2CB ; PAGE UNTIL I/O IS REACHED. 

NMEM1 

#28 
EE EFFF BNKSW 
AD EFFF BNKSW 
29 OF #OF 
C9 23 #23 
D@DA NMEM1 


THEN RESET TO PAGE 28 
AND GOTO NEXT BANK TO 
CONTINUE. (MASK INPUTS 
FROM BANKSWITCH TO SEB 
WHAT SWITCH IS SET TO) 
CONTINUE UNTIL BANK '3' 


SETUP SCREEN 


RRLP JSR 
LDX 
STX 
DEX 
STX 
STX 
LDA 
STA 
LDA 
STA 
LDX HEADING OF 'DIAGNOSTICS' WITH 


CO SCSCSCSCSCSCSCSCSC* Page 0095 FOTO 


CALL SCRN SETUP ROUTINE 
SETUP I/O AGAIN 

FOR VIA TEST 

PROGRAM DATA DIR 
REGISTERS 
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THIS SUBROUTINE 

PRINT ‘RAM’ 

SET CURSOR TO 2ND LINE 
SPACE CURSOR OUT 3 

(X STILL=@ ON RETURN) 
THE SAME SUBROUTINE 
FOR BYTES 7 - @ IN 


Se ee ee ee 


OUT EACH BIT AS A 

' ' OR '1' FOR INDICATE BAD OR MISSING RAM 
CHIPS SUBROUTINE 'RAM' RAM 

SETS UP THESE BYTES 

LOAD A '.* TO ACC. 


BCC 
LDA 
JSR 
PLA 
DEY 
BNE 
JSR 
DEX 
BPL 


LOAD A '1' TO ACC. 
AND PRINT IT 

RESTORE BYTE 

AND ROTATE ALL 8 
TIMES 

CLEAR TO END OF LINE. 


ZPG & STK TEST 


TXS 
sTY 
TYA 
STA 
STA 
INY 
TYA 
PHA 
PLA 
INY 
CPY #20 
BNE 2P1 
LDY #0 
STY ZPREG 
STX PTRLO 
INX 
STX PTRHI 
TXA 
CMP (PTRLO),¥ 
BNE ZP3 
CPX #1F 
BNE ZP2 
BEQ ROMTST 
2P3 -EQU * CHIP IS THERE, BAD ZERO AND STACK 
LDX #1A SO PRINT 'ZP' MESSAGE 
JSR MESSERR & SET FLAG (2MHZ MODE) 


ROM TEST ROUTINE 


G 
G 
ROMTST LDA #20 SET POINTERS TO 
TAY SFQOS 
LDX #OFO 
STA PTRLO 
STX PTRHI SET X TO SFF 
LDX 4#9FF FOR WINDOWING 1/0 
ROMTST1 EOR (PTRLO),Y COMPUTE CHKSUM ON 
CPX PTRHI EACH ROM BYTE, 
BNE ROMTST2 ; WINDOW OUT 
CPY #2BP ; RANGES FFCQ-FFEF 
BNE ROMTST2 
LDY #2EF 
ROMTST2 INY 
BNE ROMTST1 
INC PTRHI 
BNE ROMTST1 
TAY TEST ACC. FOR @ 
BEQ VIATST YES, NEXT TEST 
LDX #23 PRINT "ROM' AND 
JSR MESSERR ; SET ERROR 


ROUTINE 


CLC ; SET UP FOR ADDING BYTES 
CLD 

LDA ; MASK OFF INPUT BITS 
AND ; AND STORE BYTE IN 
STA TEMPOR. LOCATION 
LDA ; MASK OFF INPUT BITS 
AND ; AND ADD TO STORED 
ADC ; BYTE IN TEMP. LOC. 
ADC ; ADD REMAINING 

STA REGISTERS OF THE 
LDA ; VIA'S 

AND ; (MASK THIS ONE) 

ADC ; AND TEST 
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6D D2FF SYSD2 

6D D3FF SYSD3 

6D E2FF SYSE2 

6D E3FF SYSE3 

C9 EL #OES+ROM 
FOSS ACIA 

A2 @6 #26 

20 TBF? MESSERR 


TO SEE 

IF THEY AGREE 

WITH THE RESET 
CONDITION. 

=E1? 

YES, NEXT TEST 

NO, PRINT 'VIA' MESS 
AND SET ERROR FLAG 


ae Sa se te eee 


ACIA TEST 


CIA CLC SET UP FOR ADDITION 
LDA MASK INPUT BITS 
AND ; FROM STATUS REG 
ADC - AND ADD DEFAULT STATES 
ADC OIF CONTROL AND COMMAND 
CMP REGS. =18? 
BEQ YES, NEXT TEST 
LDX NO, "ACIA' MESSAGE AND 
JSR THEN SET ERROR FLAG 


A/D TEST ROUTINE 


ce TD LDA #OCD 

DCFF STA @EFDC 

SAC LDA PDLEN+2 

SECS LDA PDLEN+6 

5cce LDA PDLEN+4 

28 LDY #20 

ADCTST1 DEY WAIT FOR 49 USEC 
BNE ADCTST1 

AD 5DC@ LDA PDLEN+5 SET A/D RAMP 
cs ADCTST3 INY ; COUNT FOR CONVERSION 
FOOA BEQ ADCERR 
AD 66C@ LDA ADTO , IF BIT 7=1? 
3OF 8 BMI ADCTST3 ; YES, CONTINUE 
98 TYA ; NO, MOVE COUNT TO ACC 
29 ED AND #ZED ACC<32 
F2S5 BEQ KEYPLUG 
F676 ADCERR -EQU * NO, 
A2 @D LDX #2D PRINT ‘A/D' MESS 
2@ TBF? JSR MESSERR AND SET ERROR FLAG 


KEYBOARD PLUGIN TEST 


, 
AD 28C@ KEYPLUG LDA KEYBD IS KYBD PLUGGED IN? 
@A ASL A (IS LIGHT CURRENT 
1041 BPL SEX PRESENT?) NO, BRANCH 
AD DFFF LDA SYSD1 IS ERROR FLAG SET? 
BMI SEX ERROR HANG 


RECONFIGURE THE SYSTEM 


G 
RECON LDA 477 ; TURN ON SCREEN 
STA SYSD1 
JSR CLDSTRT INITIALIZE MONITOR AND DEFAULT CHARACTER SET 
BIT KBDSTRB ; CLEAR KEYBOARD 
LDA EXPROM , DISABLE ALL SLOTS 
LDA BCH2B 
LDA #18 TEST FOR "APPLE 1" 
AND KEYBD 
BNE BOOT NO, DO REGULAR BOOT 
JSR MONITOR AND NEVER COME BACK 
LDX #21 READ BLOCK @ 
STX IBCMD 
DEX 
STX IBBUFP INTO RAM AT SAGOO 
LDA #2AS 
STA IBBUFP+1 
LSR A ; FOR TRACK 82 
STA PREVIRK ; MAKE IT RECALIBRATE TOO! 
TXA 
2@ 19F4 JSR BLOCKIO 
ISSA BCC GOBOOT ; IF WE'VE SUCCEEDED. DO IT UP 
A2 1C LDX #1C 
2@ 38F7 JSR STRWT ; 'RETRY' 
26 OFFD JSR KEYIN 
BQE2 BCS Boor 
AC QOAS GOBOOT JMP PAVBS GO TO IT FOOL... 


SYSTEM EXCERCISER 


SEX LDY ; TRY FROM 

SEX1 TYA SIF TO @ 
AND ; ADD.= 
EOR ; $4E OR $4PF 
BEQ YES, SKP 
LDA -; NO, CONT 
DEY ; NEXT ADD 
BNE 


Pg 0087 076 
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LDA SET TXT 

LDA EXCERCISE 

LDA ALL 

LDA SLOTS 

LDA 

LDA DISABLE EXPANSION ROM AREA 
INY 

BNE 


RAM TEST ROUTINE 


SRENTRY LDA #72+ROM 
STA sysD1 
LDA #18 
STA ZPREG 
LDA #20 
LDX #07 
STA ZRPG1,X 
DEX 
BPL 
JSR 
PHP 
JSR 
JSR 
PLP 
ROR 
PHP 
JSR PTRINC 
BNE RAMTST1 
JSR RAMSET 
PHP 
JSR RAMRD 
PHA 
LDA #20 
STA (PTRLO),Y 
PLA 
PLP 
ROR A 
PHP 
JSR PTRINC 
BNE RAMTST4 


RETURN TO START 


LDA #2 

STA BNKSW 

STA ZPREG 

LDX #07 

LDA PHPR,X 

STA ZRPG1,X 

DEX 

BPL RAMTST6 

JSR ERROR 
4C 75F5 JMP ERRLP 


IOI I IO IOI IOI tok dO toe 


; SARA TEST SUBROUTINES 


KKKEKKKKEE KKK KKK KKK KARKKKEKKEKEK 


BD CDF4 STRWT LDA CHPG,X 
PHA 
ORA #82 NORMAL VIDEO 
JSR cour & PRINT 
INX NXT 
PLA ; CHR 
BPL STRWT 
JMP CROUT1 CLR TO END OF LINE 


SUBROUTINE RAM 


PHA ; sv acc 
TXA ; CONVRT 
LSR ; ADD TO 
LSR USE FOR 
LSR 8 ENTRY 
LSR 

PHP 

LSR 

PLP 

TAX LOOKUP 
LDA ; IF VAL 
BPL ; <@, GET 
PHA WHICH 
LDA 

AND 

TAX 

PLA 

CPX 

BEQ 

LSR 
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PROPER 
RAM 
VAL 


CONVERT 
TO VAL 


BANKSW 


? 
+ SUBROUTINE ERROR 


; 
MESSERR JSR STRWT ; PRINT MESSAGE FIRST 
ERROR LDA #2F2+ROM ; SET 1 

STA SYSD1 MHZ MO 

RTS 


; SUBROUTINE RAMSET 


RAMSET LDX 
STX 
LDY 
LDA 


SUBROUTINE PTRINC 


TRINC PHA 
INC PTRLO 
BNE RETS 
LDA BNK 
BPL PINC1 
LDA PTRHI 
CMP #13 
BEQ PINC2 
CMP #17 
BNE PINC1 
INC PTRHI 
INC PTRHI 
INC PTRHI 
BNE RETS 
DEC BNK 
DEC BNK 
JSR RAMSET1 
PLA 
LDX BNK 
CPX #OFD 
RTS 


SUBROUTINE RAMERR 


PHA 

LDX 

LDY 

BMI 

TXA 

BMI 

CLC 

ADC 

STY 

TAX 

JSR 

PLA 

PHA 

LDY #00 
EOR (PTRLO) , Y 
ORA ZRPG1,X% 
STA ZRPG1,X 
PLA 

RTS 

LDA #20 

STA BNKSW 


CT SSSCSCSCSCSCSCSCSCSCSCSCCC*S Pag 0098-GF 0779 


Apple Computer Inc. Patent : 4 383 296 


10/31/89 9:47 HD: Apple ///:ROM - Sara Tests 


BEQ 
SEC 
SBC 
INY 
BNE 


SUBROUTINE RAMWT 


EOR #OFF 
STA (PTRLO),Y 
CMP (PTRLO) , Y 


AB ~ Absolute LB - Label UD - Undefined 
RF - Ref DF - Def PR - Proc 
PB - Public PV - Private CS - Consts 


ACIA LB F63E ACIACM AB COF2 ACIACN ACIAST ADCERR 
ADCTST1 LB F663 ADCTST3 LB F669 ADRS ADTO 
BLOCKIO AB F479 BNK OG1A BNKSW BOOT 
CLDSTRT AB FD98 CNTWR F532 cout CROUT1 
DISK1 LB FS13 DISKOFF C2DS ERRLP ERRLP1L 
EXPROM CFEF GOBOOT F6BP GRMD IBBUFP 
IBNK 1419 KBDSTRB C218 KEYBD KEYIN 
KYBD COBS MESSERR FTIB MONITOR NMEM1 
NOGOOD FS2A NOMEM F548 NXBIT NXBYT 
PHPR 18128 PINC1 F7B8 PINC2 PREVTRK 
PTRINC F7A1 PTRLO G218 PULBT RAM 
RAMZ@ F772 RAM1 F776 RAMERR RAMERR2 
RAMERR4 FVE9 RAMERRS FIFZ RAMRD RAMSET 
RAMTBL F4cs RAMTSTS F6F4 RAMTST1 RAMTST4 
RAMWT FIF6 RAMWT 1 FSAl RAMWT 2 RAMWT4 
RET1 FIFE RETS FIC3 ROM ROMTST 
ROMTST2 FSFE SARATEST meas SETCVH SETUP 
SEX1 F6C4 SEX2 F6CE SEX3 SLT1 
SLT3 CIBS SLT4 C42S STK@ STRWT 
SYSD2 FFD2 SYSD3 FFD3 SYSES@ SYSE2 
TXTMD Cg51 USRENTRY F6E6 VIATST 2P1 

2P3 FSE2 ZPREG FFD@ 


Assembly complete: 545 lines 
7] Errors flagged on this Assembly 


RkKKKR KKK RK 

KkKK KK KR KKK A 

wkkKK 

ka 

x 

TORK RR RRA 

x 

ike 

FOR IO IOI a RK RR RK RK KKK 
kk kK kK 

kk 

* 

KKK KK AK 

kaKKK 

xk 

kee 

kk KR RK Rk 

kakRKK 

kK 

eed 

Rakha 

kek ka 

eK 

KKK RRR RK KK KEE KKK KK KK KK 
KK IK KKK MAK RAKERIKKRKARKEKHAKK KKK KKK KKK KK KAKA KKK KR KR 
KKK RAK KAKKKKEAKKK KAKA KK 
RR RH 

Ft ke 

kak 

KAKA KKAK 

tok ok 

Rakha KKK KKK 

kk KK 

aK 

kkk 

* 
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{ kk 
| RARER RAK KEKE KEKKKKKKAKKKK KK 
| KEKE KKK KK KKK 
: { kanK 
TAX : 4 | tke 
TAY : | o** 
TXA : | week Kk 
TXS : | o** 
TYA : oleiala 


Minimum frequency 
Maximum frequency 


Average frequency 
Unused opcodes: 
BRK BVC BVS CLI CLV NOP ROL RTI SED SEI 


Program opcode usage: 8@ %& 


(1.08) That's all, Folks ... 


Fas 10 F077 
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00000000 0000000 000 0 0 0 0 


O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
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CEASE EKA CERES EEK EEMES EEE KEE KEK Eee KEE E Ke EEE EEE EES 
@ APPLE /// ROM — MONITOR 

;@ COPYRIGHT 1979 BY APPLE COMPUTER 

rEPeE PPP EPEPOTEET TT ENTTTTTTETTTPELOLeTTT TTT TTT Ter T rT ty 


-ABSOLUTE 
-PROC MONITOR 
ORG OF TFE 


RTS 
-BYTE 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
SBC 
BEQ 
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RET2 


e 


SCRNLOC 


LMARGIN SCRNLOC 
RMARGIN . SCRNLOC+1 
WINTOP SCRNLOC+2 
WINBIM SCRNLOC+3 
CH SCRNLOC+4 
cv SCRNLOC+5 
BAS4L SCRNLOC+6 
BAS4H SCRNLOC+7 
BAS8L 2 SCRNLOC+8 
BAS8H SCRNLOC+9 
TBAS4L SCRNLOC+A 
TBAS4H SCRNLOC+2B 
TBAS8L SCRNLOC+2C 
TBAS8H SCRNLOC+2D 
FORGND SCRNLOC+9E 
BKGND SCRNLOC+@F 
MODES SCRNLOC+12 
CURSOR SCRNLOC+11 
STACK SCRNLOC+12 
PROMPT SCRNLOC+13 
TEMPX SCRNLOC+14 
TEMPY SCRNLOC+15 
CSWL SCRNLOC+16 
CSWH SCRNLOC+17 
KSWL SCRNLOC+18 
KSWH SCRNLOC+19 
PCL SCRNLOC+1A 
PCH SCRNLOC+1B 
AlL SCRNLOC+1C 
AlH A1L+1 

A2L A1L+2 

A2H A1L+3 

A3L A1L+4 

A3H A1L+5 

A4L A1L+6 
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27B A4H 

BIC STATE 
@27D YSAV 
OS7E INBUF 
DOBS TEMP 
BB69 MASK 


Coes KBD 
cals KBDSTRB 


2358 USERADR 
F479 BLOCKIO 
F686 RECON AS OF 12/26/1979 
F4EE DIAGN 
@O52 INBUFLEN ONLY 8@ BYTES ($3A@-$3EF) 
@281 IBSLOT 
IBDRVN IBSLOT+1 
IBBUFP IBSLOT+4 
IBCMD IBSLOT+6 


G 
ENTRY id 


STACK 
MON MUST BE HEX MODE 
BELL 
MONZ STACK RESTORE STACK TO ORIGINAL LOCATION 


#2DF PROMPT (APPLE) FOR SARA MONITOR 
PROMPT 
GETLNZ 
SCAN ZSTATE 
NXTINP GETNUM 
YSAV 
#12 


GET A LINE OF INPUT 

SET REGULAR SCAN 

ATTEMPT TO READ HEX BYTE 
STORE CURRENT INPUT POINTER 
18 COMMANDS 


CMDSRCH 
MON 
CMDTAB, Y 
CMDSRCH 
TOSUB 
YSAV 
NXTINP 


GIVE UP IF UNRECOGNIZABLE 
FOUND? 

NO KEEP LOOKING 

PERFORM FUNCTION 

GET NEXT POINTER 

DO NEXT COMMAND 


we Se te Me te Me 


GETNUM #2O 

A2L 

A2H 
NXTCHR (INBUF), ¥ 


CLEAR A2 


BUMP INDEX FOR NEXT TIME 
#QBS 
#OA TEST FOR DIGIT 
DIGIT SAVE IT IF 1-9 
#88 TEST FOR HEX A-F 
#OFA 
DIGRET 
#23 


NXTBIT ASL SHIFT HEX DIGITS INTO A2 
ROL A2L 
ROL A2H 
DEX 
BPL NXTBIT SHIFTED ALL YET? 
NXTBAS LDA STATE 
BNE NXTBS2 IF ZERO THEN COPY TO Al,3 
LDA A2H, X 
STA A1H, X 
STA A3H, X 
NXTBS2 INX 
BEQ NXTBAS 
BNE NXTCHR 


7 SWITCH ROUTINE FOR CHARACTER 


TOSUB LDA 4OFA PUSH ADDRESS OR FUNCTION 
PHA AND RETURN IT 
LDA CMDVEC, ¥ 
PHA 
LDA STATE PASS MODE VIA ACC. 
ZSTATE LDY #20 
STY STATE RESET STATE OF SCAN 
DIGRET RTS 
CMDTAB .EQU 
.BYTE 
«BYTE 
«BYTE 
«BYTE 
-BYTE 
-BYTE 
-BYTE 
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=GP (CALL) SUBROUTINE 
=JUMP (CONT) PROGRAM 
=MOVE MEMORY 

=READ DISK BLOCK 
=MEMORY SEARCH 

=USER FUNCTION 
=VERIFY MEMORY BLOCKS 


“ann Zan 
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=WRITE DISK BLOCK 
=REPEAT COMMAND LINE 
=SPACE (BYTE SEPARATOR) 
=ASCII (HI BIT ON) 
=ASCII (HI BIT OFF) 
=SET STORE MODE 

=RANGE SEPARATOR 
=COMMAND SEPARATOR 
=DEST/SOURCE SEPARATOR 
=CARRIAGE RETURN 


OME 
Ee] 


QAN:  « 


Nee Se Ne Ne Se te Se te te 


SEARCH-1 
USER-1 
VRFY-1 
WRTIE-1 
REPEAT-1 
SPCE-1 
ASCII-1 
ASCII@-1 
SETMODE-1 
SETMODE-1 
SEP-1 
DEST-1 
CRMON-1 


Pee i ee ee ee ee Ty 


BUMP 16 BIT POINTERS 
BUMP Al 


IN CASE OF ROLL OVER 


IF Al LESS THAN OR EQUAL TO A2 
THEN CARRY CLEAR ON RETURN 


SAVE LOW NIBBLE 


SHIFT HI NIBBLE TO PRINT. 


PRHEXZ 


PRHEX 4OFr STRIP HI NIBBLE 
PRHEXZ HOBO MAKE IT NUMERIC 
#2BA Is IT >'9° 
PRHEX2 
#26 MAKE IT ‘A'-'F* 
PRHEX2 COUT 


r 
PRBYCOL PRBYTE 


PRCOLON #OBA PRINT A COLON 
PRHEX2 BRANCH ALWAYS 


G 

TST8@WID #07 ANTICIPATE 
MODES TEST FOR 8 
SVMASK 
#OFr 
MASK 


TEST FOR NEW PC 
OLDPC 
ALL,X 
PCL,X 


A1PC1 


MASK SAVE HI BIT STATUS 
YSAV MOVE ASCII TO MEMORY 
(INBUF), ¥ 

YSAV ; BUMP FOR NEXT THING. 
#20 
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#OAR2 - ASCII ™ ? 

ASCII3 NOPE, CONTINUE. 
MASK 

BITON HE'S CHANGED MODES. 


ASCIT3 #OA7 ASCII ' ? 
CRCHK NO, TEST FOR EOL. 
MASK 
BITOFF CHANGE MODES. 


#8D END OF LINE? 

ASCDONE YES, FINISHED 

MASK 

STOR1 GO STORE IT! 

ASCII2 DO NEXT. 
ASCDONE 


’ 


SEARCH (A1L),Y LOAD SEARCH BYTE 
A4L 
SRCH1 
PRINTA1 DUMP MEMORY 
CROUT 
NXTA1 INCREMENT POINTER 
SEARCH CONTINUE SEARCH 

RETURN 


ASCII INDICATE HI ON, 
9D (BCC - NEVER TAKEN) 
ASCII® INDICATE HI OFF 
CKMDE SAVE STATE 
STATE RETAIN STATE 
#OBA ARE WE IN STORE MODE? 
ERROR 
BITON #OFF SET HI BIT UNMASKED 
ASCITI1 
BITOFF #7F MASK HI BIT 
ASCII1 ALWAYS BRANCHES 
REPEAT KBD REPEAT UNTIL KEYPRESS 
REPEAT 1 
KEYIN 
REPEAT1 CLEAN UP STACK 
LFA36 
4c 12F9 SCAN 


? 

’ 
20 B4FA CRMON BL1 
4C @8F9 MONZ 


G 
22 9DF9 MOVE TSTAL TEST VALID RANGE 
B@5SD ERROR 

Bl 74 MOVNXT (A1LL),Y COMPARE BYTE FOR BYTE 
91 7A (A4L),Y 

22 8EF9 NXTA4 BUMP BOTH Al AND A4 
9Or7 MOVNXT 

62 ; ALL DONE WITH MOVE 


2@ 9DF9 TSTAL TEST VALID RANGE 
B24E ERROR 

Bl 74 (A1L),Y COMPARE BYTE FOR BYTE 
Dl 7A (A4L),Y MATCH? 

F226 VRFY2 YES, DO NEXT. 

2@ 66FA MISMATCH ; PRINT BOTH BYTES 

2@ EFFC CROUT GOTO NEWLINE 

2@ 8EF9 NXTA4 BUMP BOTH Al AND A4 
ISEF VRFY1 

62 + VERIFY DONE. 


? 
MISMATCH A4H PRINT ADDRESS OF A4 

PRBYTE 

A4L 

PRBYCOL ; OUTPUT A COLON FOR SEPARATOR 

(A4L),Y¥ AND THE DATA 

PRBYTSP PRINT THE BYTE AND A SPACE 
PRINTA1 PRSPC LEAD WITH A SPACE 

AlH OUTPUT ADDRESS Al 

PRBYTE 

AlL 

PRBYCOL SEPARATE WITH A COLON 
PRAIBYTE (A1L),¥ PRINT BYTE POINTED TO BY Al 
PRBYTSP PRBYTE 
PRSPC #OAD PRINT A SPACE 

court END VIA OUTPUT ROUTINE. 


USER USERADR 


’ 
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LEAVE STACK WITH NOTHIN‘ ON IT. 
A1PC STUFF PROGRAM COUNTER 
@PCcL ; JUMP TO USER PROG. 


RWERROR i PRINT ERROR NUMBER 

PRBYTE PRINT THE OFFENDER 

#2AL FOLLOWED BY A "1!" 

COUT 
ERROR2 NOSTOP ; OUTPUT A CARRIAGE RETURN (NO STOPLST) 
ERROR MON 


é 

DEST A2L COPY A2 TO A4 FOR DESTINATION OP 
A4L 
A2H 
A4H 


‘ 
SEP SPCE SEPARATOR TEST STORE MODE OR DUMP. 
ZERO MODE. 
SETMDZ BRANCH ALWAYS 


¢ 
BL1 YSAV TEST FOR NO LINE 
DUMP 8 IF NO LINE, GIVEM A ROW OF BYTES 
SPCE ; TEST IF AFTER ANOTHER SPACE 
SETMDZ 
#OBA STORE MODE? 
TSTDUMP 
STATE KEEP IT IN STORE STATE 
A2L GET BYTE TO BE STORED 
(A3L),Y PUT IT IN MEMORY. 
A3L BUMP POINTER 
DUMMY 
A3H 
DUMMY ALSO USED FOR '/' TO CLEAR MODE 


‘ 
SETMODE YSAV USE INPUT CHARACTER 


(INBUF), Y TO SET MODE 
SETMDZ STATE 


? 
READ #01 GET DISK COMMAND TO READ 
2c DUMMY BIT TO SKIP 2 BYTES 
WRTE #B2 SET DISK COMMAND TO WRITE 
SAVCMD IBCMD 
RWLOOP A1L 
IBBUFP COMMAND FORMAT IS 
AlH BLOCKNUMBER <ADDRESS END ADDRESS 
IBBUFP+1 
A4H SEND BLOCK NUMBER VIA X & A 
A4L 
NO INTERRUPTS WHILE IN MONITOR 
BLOCKIO DO DISKO FEVER 
RWERROR GIVE UP IF ERROR ENCOUNTERED 
AAL BUMP BLOCK NUMBER 
NOVER 
A4H 
AlH BUMP RAM ADDRESS BY 512 BYTES 
AlH 
TSTA1 TEST FOR FINISHED 
RWLOOP NOT DONE, DO NEXT BLOCK 


AlH 
A2H 
TST8QWID ; GET WIDTH MASK INTO ACC 
ALL 
A2L 
DUMP@ BRANCH ALWAYS 
; 
TSTDUMP A DUMP ? 
ERROR1 ERROR 
DUMP TST8QWID ; SET FOR EITHER 8@ OR 48 COLUMNS 
DUMPS ALL 
A4L 
AlH 
A4H 
TSTAIL TEST FOR VALID RANGE 
ERROR1 
PRINTAL ; PRINT ADDRESS AND FIRST BYTE 
NXTA1 
DUMPASC END WITH ASCII 
AlL TEST END OF LINE 
MASK FOR 428/88 COLUMN 
DUMP 3 
DUMPASC 
DUMP 1 ; BRANCH ALWAYS 
PRAIBYTE ; GO PRINT NEXT BYTE AND A SPACE 
DUMP 2 ALWAYS (ACC JUST PULLED AS $A9) 
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DUMPASC RESET TO BEGINNING OF LINE 


PRINT AN EXTRA SPACE 
TO INDEX MEMORY INDIRECT 


SET NORMAL VIDEO 

TEST FOR CONTROL CHARACTERS 
OK TO PRINT NON CONTROLS 
OTHERWISE PRINT A SPACE 
POT IT OUT 

BUMP BOTH Al AND A4 
FINISHED 

TEST END OF LINE 


ee Ne te Se te tee 


NOT DONE, PRINT NEXT 


a 


INDICATE 8@ COLUMNS 
OCB53 GOTO 82 COLUMN MODE 
SET8@ BRANCH ALWAYS 


INDICATE 48 COLUMNS DESIRED 
AD 52C@ PBCBS2 ; GOTO 4@ COLUMN MODE 
AS 68 MODES 
29 48 #49 ; ASSUME 82 
BQG2 SET8@A AND BRANCH IF IT IS 
29 BF #OBE ; BUT FIX FOR 49 IF NOT 
85 68 SET8@A MODES 
@9 TF #7F ; ISOLATE BIT 7 
29 AS #QAD ; (BIT 7 SETS NORMAL/ INVERSE) 
85 66 FORGND 
SET82B ; AGAIN ASSUMES 8@ COLUMNS 
#OFD ; IF NOT, SET FOR/BACKGROUND COLOR 
SET82B BKGND 


CLSCRN LMARGIN SET CURSOR TO TOP LEFT OF WINDOW 
CH 
WINTOP 
cv ; NOW DROP INTO CLEAR END OF PAGE 


; 
CLEOP CH ; SAVE CURRENT CURSOR POSITION 
cv 


SETCV 
CLEOP1 CLEOL CLEAR TO END OF FIRST LINE 
LMARGIN 
CH 
CURDOWN GOTO NEXT LINE 
CLEOP1 


RESTORE CURSOR POSITION 
CH 
GET OLD CV IN ACC AGAIN 
SETCV BRANCH ALWAYS 
CLEOL CH ; CLEAR TO END OF LINE FIRST 
4C 89FC CLEOL1 
C9 82 CONTROL #82 
9865 DISPLAYX IF INVERSE 
c9 8D TSTCR #8D IF CARRIAGE RETURN THEN NEW LINE 
D@3A TSTBACK 
28 A2FB CARRAGE CLEOL FIRST CLEAR TO THE END OF THIS LINE 
28 D7FB SETCHZ RESET CURSOR AND GOTO NEXT LINE (CARRY IS SET) 
4C 16FC NXTLIN THEN GOTO THE NEXT LINE. 


AS 5D cv TEST FOR TOP OF SCREEN 
cé SD cv ANTICIPATE 'NOT' TOP 
CS SA WINTOP 

DBS2 CURUP1 IT'S NOT TOP, CONTINUE 
AS 5B WINBTM WRAP AROUND TO BOTTOM 
38 CURUP1 DECREMENT BY ONE 

E9 @1 $21 

85 5D SETCV cv ; SAVE NEW VERTICAL LINE 
FBC7 BASCALC * 

FBC7 CURDN1 - 

AS 5D cv GET VALUES FOR FIRST PAGE ($4@®) 
104E BASCALC1 ALWAYS 


24 68 CURIGHT MODES TEST FOR 88 OR 48 

71862 RIGHT1 

E6 5C CH 

E6 5C RIGHT1 CH BUMP CURSOR HORIZONTAL 
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AS 5C LDA TEST FOR NEW LINE 

C5 59 CMP 

AS 58 SETCHZ LDA JUST IN CASE WE HAVE. 

925D BCC 

85 SC SETCVH STA CURSOR AT START OF NEXT LINE 
7 DROP INTO CURDOWN FOR WRAP AROUND 


E6 5D CURDOWN cv MOVE CURSOR DOWN ONE LINE 
AS 5D cv ANTICIPATE NOT BOTTOM 

cS SB WINBTM TEST FOR BOTTOM 

9DE2 CURDN1 

AS SA WINTOP 

B@DC SETCV BRANCH ALWAYS 

c9 88 TSTBACK #88 BACKSPACE? 

D@5D TSTBELL 

24 68 CURLEFT TEST FOR FOURTY OR EIGHTY MODE 
19B2 

cé SC 

Ccé SC LEFT8@ 

386 

AS SC TEST FOR WRAP AROUND 

C5 58 

13B CTRLRET 

28 BSFB LEFTUP CURUP 

AS 59 RMARGIN 

85 SC CH SAVE NEW CURSOR POSITION 
DET CURLEFT BRANCH ALWAYS 


C9 AS COUT2 42RD IS IT CONTROL CHARACTER 
99D CONTROL 

24 68 MODES TEST FOR INVERSE 

3882 DISPLAYX ; NO PUT IT OUT 

29 TF #7F ; STRIP HI BIT 

28 9DFC DISPLAYX DISPLAY 


28 CBFB INCHORZ CURIGHT MOVE CURSOR RIGHT 
NXTLIN SCROLL IT'S BOTTOM, RESET CH=@ AND SCROLL 
6B RESET CH ONLY 


BASCALC1 CALC BASE ADR IN BAS4L,H 


FOR GIVEN LINE NO. 
@<=LINE NO.<$17 
; ARG=Z@@ABCDE, GENERATE 
; BAS4H=@22221CD 


AND 
BAS4L=EABAB@OO 


BSCLC2 


SAME FOR PAGE 2 
CTRLRET 


COUT SAVE CHARACTER 
TEMPY 
TEMPX 
courtl 
TEMPY 
TEMP X 


couT1 @CSWL NORMALLY COUT1 


TSTBELL #87 BELL? 

LNFD NO TEST FOR FORM FEED 
AE 48C2 BELL CHAD SOUND BELL 
6f 
C9 8A LNFD #8A 7 LINE FEED? 
D@E2 CTRLRET 
2@ DDFB CURDOWN MOVE CURSOR DOWN A LINE 
9@DD CTRLRET BRANCH IF NO SCROLL NECESSARY. 
AS SA SCROLL WINTOP START WITH TOP LINE 
48 SAVE IT FOR NOW 
28 SETCV GET BASCALC FOR THIS LINE 
A2 @3 SCRL1 #03 MOVE CURRENT BASCALC AS DESTINATION 
BS SE SCRL2 BAS4L, X 
95 58 TBAS4L,X (TEMPORARY BASE ADDR.) 
CA 
12F9 SCRL2 
68 GET DESTINATION LINE 
18 
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CALCULATE SOURCE LINE. 

IS IT THE LAST LINE? 

YES, CLEAR IT 

SAVE AS NEXT DESTINATION LINE 
GET BASE ADDR FOR SOURCE LINE 
MOVE SOURCE TO DESTINATION 
DIVIDE BY 2 


DONE YET 
SCRL1 YES, DO NEXT LINE 
(BAS4L) , ¥ 
(TBAS4L) ,Y 
(BAS8L) , ¥ 
(TBAS8L) , Y 
SCRL3 BRANCH ALWAYS 
LASTLN LMARGIN BLANK FILL THE LAST LINE 
CLEOL1 A DIVIDE BY 2 


CLEOL2 
FORGND (NORMALLY A SPACE) 
(BAS4L), Y 
CLEOL2 BKGND (IF 8@ COLUMNS, ALSO A SPACE) 
(BAS8L) , Y 


TEST FOR END OF LINE 
MULT BY 2 AGAIN 


CONTINUE IF MORE TO DO. 
ALL DONE. 


Ase 


DISPLAY 


TEST FOR 48 OR 8@ 

STORE THE SINGLE CHARACTERS AND RETURN 
INSURE PROPER 4@ COLUMN DISPLAY 

BY DROPPING BIT @ 

DISPLAY IN $42@ PAGE. 

ALSO SET BACKGROUND COLOR 


DSPL82 
BKGND 
DSPBKGND (BAS8L) , Y 


We a Ne ve te te 


DSPL8@ PRESERVE CHARACTER 
CH DETERMINE WHICH PAGE 
A 


DSPBKGND BRANCH IF $92@ PAGE 
(BAS4L) ,Y¥ 


(INBUF) , Y ECHO CHARACTER 
COUT 
#88 BACKSPACE 
BKSPCE 
#98 CANCEL? 
CANCEL 
TEMP 
TEMP 
#INBUFLEN 
NXTCHAR NO WRAP AROUND ALLOWED. 
CANCEL #@DC OUTPUT BACKSLASH 
COUT 
CROUT 
GETLNZ - 
GETLN PROMPT 
COUT 
#21 
TEMP START AT BEGINNING OF INBUF 
BKSPCE TEMP 
GETLN 
TEMP BACK UP INPUT BUFFER 
NXTCHAR RDCHAR GET INPUT 
TEMP 
(INBUF) , Y 
#8D 
NOTCR 
x 
KBD 
NOSTOP 
KEYIN3 
#OA@ 
STOPLST 
#89 
NOSTOP 
ERROR2 
STOPLST KBD 
STOPLST 
NOSTOP #8D 
4C 39FC COUT 


TEST FOR START/STOP 


a 


READ KBD 

IS IT A SPACE? 

YES, PAUSE TIL NEXT KEYPRESS. 
QUIT THIS OPERATION 

NO, IGNORE THIS KEY. 

YES, RESTART 


; 
6C 7222 RDKEY @KSWL 


‘ 
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A9 7F KEYIN #7F MAKE SURE FIRST IS CURSOR 
85 63 TBAS4H 
28 88FD PICK GO READ SCREEN 
48 KEYIN1 SAVE CHR AT CURSOR POSITION 
28 35FD KEYWAIT TEST FOR KEYPRESS 
B2G8 KEYIN2 ; GO GET IT 
AS 69 CURSOR GIVE THEM AN UNDERSCORE FOR A TIME 
28 9DFC DISPLAY 
2@ 35FD KEYWAIT ¢ GO SEE IF KEYPRESSED 
KEYIN2 
SAVE KEYPRESS STATUS 


DISPLAY 


KEYIN1 
KEYIN3 KBD READ KEYBOARD 
KEYIN4 KBDSTRB CLEAR KEYBOARD STROBE 


KEYWAIT TBAS4L JUST KEEP COUNTING 
KWAIT2 
TBAS4H 
#7F TEST FOR DONE 


TBAS4H 

KEYRET RETURN IF TIMED OUT 
KWAIT2 KBD 

KEYWAIT 
KEYRET 


7 
ESC3 = 
GOESC 
ESCAPE MODES SET TO + SIGN FOR CURSOR MOVES 
#82 
#@AB 
CURSOR 
RDKEY READ NEXT CHARACTER 
#28 TEST FOR ESCAPE COMMAND 
ESCTABL, Y 
ESC3 


ESC2 LOOP TIL FOUND OR DONE 


? 

RDCHAR $8D GO READ A CHARACTER 
MODES 
CURSOR SAVE STANDARD CURSOR 
RDKEY 
#9B ESCAPE CHARACTER? 
ESCAPE 
#95 FORWARD COPY? 
KEYRET 

20 88FD PICK GET CHARACTER FROM SCREEN 

#82 SET TO NORMAL ASCII 


#@FB 


ESCVECT, Y 


ESCVECT CLEOL-1 
CLEOP~-1 
CLSCRN-1 
COL48-1 
COL8¢-1 
CURLEFT-1 
CURIGHT-1 
CURDOWN-1 
CURUP-1 


Nan Tee te se te tee 


GET A CHARACTER AT CURRENT CURSOR POSITION 
DETERMINE WHICH PAGE. 


MODES 

PICK4@ 

PICK4@ 
(BAS8L),Y 


AND IF 88 COLUMN MODE 
FORGET CARRY IF 4% COLUMNS 
GET CHARACTER FROM $460 


PICK4@ (BAS4L),Y 


CLDSTRT = 
#03 
OFFDS ZERO PAGE IS ON 3! 
SETUP x 
OF COURSE! 
#3 
INBUF+1 
BD BCFF NMIRQ, X 
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9D CAFF OFFCA,X 
HOOKS, X 
CSWL,X 
VBOUNDS, X 
LMARGIN, X 


SETUP1 

IBDRVN 

#@Ae INPUT BUFFER AT $3A2 

INBUF 

#68 

IBSLOT 

#2FF 

MODES 

COL4 SET 4@ COLUMNS, CLEAR SCREEN 


? 

ADR GAD 
CPORTL ADR 
CPORTH ADR+1 
CTEMP ADR+2 
CTEMP 1 ADR+3 
YTEMP ADR+4 
ROWTEMP ADR+2@ 
CWRION @C2DB 
CWRIOFF 2CODA 
CB2CTRL @EFEC 
CB2INT QF FED 


e 


GENENTR #78 INIT SCREEN INDX LOCATIONS 
CPORTL 
#08 
CPORTH 
#OFD ; SET UP INDEX TO CHRSET 
YTEMP 
#2 


2IPTEMPS ROWTEMP , X 


#20 

ZIPTEMPS 

#25 FAKE THE FIRST BIT PATTERN 
(PHANTOM 9TH BIT SHIFTED AS BIT @) 


GENASC CTEMP GENERATE THE ASCII 
GASCI1 #27 CODES FOR THE FIRST PASS 
GASCI2 CTEMP 
GASCI3 

(CPORTL) ,Y $XXF=CHR 
$XXE=CHR 
$XXD=CHR 
$XXC=CHR 
$XXB=CHR 
$XXA=CHR 
$XX9=CHR 
$XX8=CHR 
GO DECODE CHARACTER TABLE 
SECOND SET OF 4? 


GASCI4 
#23 
GASCI3 
GASCI2 
GASCI4 NXTPORT 
CBYTES 
#OA 
GASCI1 
#24 
GENASC 


WNHHRAWNEH EA 
SAU SAWHO DS 


BRANCH ALWAYS 
RESTORE BIT PATTERN 


CBYTES 


#17 
CCOLMS #25 
CSHFT ROWTEMP+4,X 
A 
SHFTCNT 
CTEMP 
YTEMP 
DONE 
YTEMP 
CHRSET-1,Y 
A 


(4 CHARACTERS OF 6 ROWS) 

(FIVE COLUMNS) 

BREAK BYTE INTO 

5 BIT GROUPS 

BRANCH IF MORE BITS IN THIS BYTE 


(NOTE. CARRY IS SET) 
BRANCH IF ALL DONE 
GET CHARACTER TABLE INDEX 


(CARRY KEEPS BYTE NON-ZERO UNTIL ALL 8 ARE 
ARE SHIFTED) 

RESTORE COLUMN COUNT 

GOT ALL FIVE BITS? 

NO, DO NEXT 

ALL ROWS DONE 

NO, DO NEXT 

SAVE REMAINING BIT PATTERN AND CARRY 


CTEMP 
SHFTCNT 
CSHFT 


CCOLMS 


STORCHRS 
4C @1FE CBYTES 


MOVE EM TO NON DISPLAYED VIDEO AREA 


FE28 DONE 


‘ 
A2 1F STORCHRS MOVE CHARACTER PATTERNS TO VIDEO AREA 
AD 2B STORSET 
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STOROW ROWTEMP, X 
A SHIFT TO CENTER 
#3E STRIP EXTRA GARBAGE 
(CPORTL) ,Y 


#28 ; THIS GROUP DONE 
STOROW ; NO, NEXT ROW 
NXTPORT 

#98 

GENDONE ALL ROWS STORED? 


STORSET 
PARTIAL SET ($478-$5FF) 


GENDONE #81 SET NORMAL MODE 
CTEMP 
GEN1 #60 
CWRTON 
VRETRCE 
#28 
VRETRCE 
CWRTOFF 
ALTCHR 
CTEMP 
GEN2 
#28 
CPORTH 
NXTASCI #27 ; THE USUAL COUNTDOWN 
NXTASC2 (CPORTL) , Y 


PREPARE TO SEND BYTES TO CHARACTER 
GENERATOR RAM 

WAIT FOR NEXT VERTICAL RETRACE 
WAIT AGAIN 


CHARACTERS ARE NOW LOADED 

REPEAT THIS SET FOR OTHER 64 CHARACTERS 
HAVE WE DONE ALTERNATES YET? 

NO, DO IT! 

BUMP ASCII VALUES FOR NEXT SET 


SEO reC rec racy? 


#28 
(CPORTL) , Y 


NXTASC2 
NXTPORT 
NXTASCI 


#23 SETUP ALTERNATE WITH UNDERLINES 
#7P 

OSFC,Y 

BIEC,Y 


UNDER 
#08 
CPORTH 
GEN1 


ALTCHR #27 7 ADJUST ASCII FOR ALTERNATE SET 
ALTC1 {CPORTL) , Y 

#20 7 $28--> $48-->S66 

(CPORTL) , Y 


ALTC1 ADJUST THEM ALL 
NXTPORT 
ALTCHR 


NXTPORT CPORTL CONVERT $78->$F8 OR $F8-$78 
$82 
CPORTL 
NOHIGH 
CPORTH 

NOHIGH CPORTH 
#0C 
PORTDN 
#24 
CPORTH 

PORTDN 


' 
VRETRCE CTEMP1 SAVE BITS TO BE STORED 
CB2CTRL CONTROL PORT FOR 'CB2* 
#3F RESET HI BITS TO @ 
CTEMP1 
CB2CTRL 
#28 TEST VERTICAL RETRACE 
CB2INT 
VWAIT CB2INT WAIT FOR RETRACE 
VWAIT 


CHRSET * 


‘ 


OFS,21,82,18,48, 84,81, 2F, 58, 44,81, 29,82, 1E,81, 91,7C,1F,49, 38 
8A,28,43,14,31,2A, 22,13, 283, @F7,0C4, 91,48, @A2, ODA, 24,2C6,4A 


62, 8C, 24, 0C6, OF8, 63, BC, SC1l, 46,17, 52, 8A, BAF, 16, 14, @E3, 33, 31 
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@C6,0F8,@DC,73,3F,46,17, 62, 8C, 21, @E6,18, 6A, 8D, 61, 9CF,18, 62 
74,@D1,2B9,18,49,4C, 91,8CO, OF3,29, 2C, 91, C8, 14, 1D, 8C, OEF, 07 
17,43, 88,31, 84,1E, ODF, OB, 31, 84,F8,OFE, 77, 3E, 3E, 17,62, 8C, @FD 
@C7, 58,8E3,2B, 51,8C5,0B8,2C8,73,18,0C,42,3E,01,02,20,42,3E 
41,18, 8C, 28,208, 78, GEE, @,11,11,21,11,82, GES, 3C, 21, 31,82, BES 
1C, 98, @C8, OB9, 88, 62,14,1F, 46,2A2, ODE, 43, 2C, 04, 88, OBE, OFF, ACE 
7D, 37,49, 88, 95,18, 98,09, 62,@D1, 44, OE8, 88, OFB, 22, 98,49, 28,19 
GED, 3,982, 00,48, GS, 9B, OB, 2B, GB, 28, 18,42, 44,25, 82,8B8,2F, 48 
25,44,19,82, 22,08, 2F,5A, 42,45, 02, BE, 64,58, 98,21, 3B, 26,42,88 


21,88, 28,805,008, OF8, 88,208,025, 08, @F8, 86, 28,85, 88 


HOOKS * 
CouT2 
KEYIN 

VBOUNDS * 

02,58, 08,18 


‘ 
NMIRQ RECON 7 IN DIAGNOSTICS 


‘ 


"COPYRIGHT JANUARY, 1988 APPLE COMPUTER INC..JRH" 
TD 


ESCTABL SCC, GDS, D3, OB4, OBS, 88, 95, 8A, 8B, GB 


? 
NMI OF FCA 
RESET DIAGN 7 NOTHING 


SYMBOL TABLE DUMP 


AB ~- Absolute LB - Label UD - Undefined 
RF - Ref DF - Def PR - Proc 
PB - Public PV — Private CS - Consts 


AlH A1L W274 
A2L A3H @279 
ADR ALTC1 FE8A 


| Alpc A2H 

| A3L A4L 

| ALTCHR ASC2 
ASC3 ASCDONE FA@8 | ASCII ASCII1 
ASCII2 ASCII3 F9F4 | BAS4H BAS8H 
BAS 8L BASCALC FBC7 | BASCALC1 BITOFP 
BITON BKGND @267 | BKSPCE BLOCKIO 
BSCLC2 CANCEL FCCD | CB2CTRL CB2INT 
CBYTES CCOLMS FE@S | CHRSET CKMDE 
CLDSTRT CLEOL FBA2 | CLEOL2 CLEOP 
CLEOP1 CLSCRN FB7D | CMDTAB 

COL4@ COL8S FB5D COUT 

couT2 CPORTH @2A1 CPORTL CRCHK 

CROUT CSHFT FE@? CSWH CSWL 

CTEMP 1 CTRLRET FC38 CURDN1 CURDOWN 

CURLEFT CURSOR 2269 CURUP CURUP 1 

CWRIOFF CWRTON C2DB DEST DIAGN 

DIGRET DISPLAY FC9D DISPLAYX DONE DSPBKGND 
DSPL8S DUMMY FACB DUMP DUMP® DUMP1 
DUMP2 DUMP3 FB32 DUMP 8 DUMPASC ENTRY 
ERROR ERROR1 FB@B ERROR2 ESC1 ESC2 
ESC3 ESCAPE FD4B ESCTABL ESCVECT FORGND 
GASCI1 GASCI2 FDES GASCI3 GASCI4 GEN1 


C=*S GOTT TOTTI 
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GEN2 
GETLNZ 
TBBUFP 
INBUFLEN 
KBDSTRB 
KEYIN4 
KWAIT2 
LMARGIN 
MON 

NMI 
NOVER 
NXTBAS 
NXTINP 
PCL 
PRBYCOL 
PRHEX2 
RDCHAR 
REPEATL 
RETAL 
RWLOOP 
SCRL3 
SET82Z 
SETCVH 
SHFTCNT 
STOPLST 
STORSET 
TBAS8L 
TST8@WID 
TSTDUMP 
VRETRCE 
WINBTM 
ZIPTEMPS 


Assembly 
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FE75 
FCDS 
@285 
O05 
Cole 
FD31 
FD42 
@O5B8 
F9@4 
FFFA 
FAF3 
F94F 
F915 
OB12 
F9C4 
F9C1 
FD62 
FA35 
F9AD 
FADB 
FCTA 
FB67 
FBDB 
FE1A 
FD@2 
FE2A 
O64 
F9CB 
FBOA 
FEAE 
@25B 
FDD5 


complete: 
@ Errors flagged 


Ww 


WWOMWTINr Oh «1 


WRNHRUN MTD UO 


GENASC 
GETNUM 
IBCMD 
INCHORZ 
KEYIN 
KEYRET 
LASTLN 
LNFD 
MONITOR 
NMIRQ 
NXTA1 
NXTBIT 
NXTLIN 
PICK 
PRBYTE 
PRHEXZ 
RDKEY 
RESET 
RIGHT1 
SAVCMD 
SCRNLOC 
SETS8@A 
SETMDZ 
SPCE 
STOR 
SVMASK 
TEMP 
TSTA1 
UNDER 
VRFY 
WINTOP 
2STATE 


FDE1 
F92C 
CD87 
FC13 
FDOF 
FD47 
FC87 
FC52 
FFBC 
F994 
F947 
FC16 
FD88 
F9AE 
F9B9 
FDSC 
FFFC 
FBD1 
FAD9 
@258 
FB6F 
FAD1 
FAB8 
FABF 
F9D3 
OBES 
F99D 
FET9 
FA4F 
O25A 
F967 


1129 lines 
on this Assembly 


KARR RK Ok 
aRkkR RK K 


KRRKKKKK KK KKK 
KHEKKKKEKKEKEE 


GENDONE 
GO 
IBDRVN 
IRQ 
KEYIN1 
KEYWAIT 
LEFT82 
MASK 
MONZ 
NOHIGH 
NXTA4 
NXTBS2 
NXTPORT 
PICK4@ 
PRBYTSP 
PRINTAL 
READ 
RET1 
RMARGIN 
SCAN 
SCROLL 
SET82B 
SETMODE 
SRCH1 
STORL 
TBAS4H 
TEMPX 
TSTBACK 
USER 
VRFY1 
WRTE 


GENENTR LB 
GOESC LB 
IBSLOT AB 
LB 
LB 


MISMATCH 
MOVE 
NOSTOP 
NXTASC2 
NXTCHAR 
OLDPC 
PORTDN 
PRCOLON 
PROMPT 
RECON 
RET2 
ROWTEMP 
SCRLI 
SEARCH 
SETCHZ 
SETUP 
STACK 
STORCHRS 
TBAS4L 
TEMPY 
TSTBELL 
USERADR 
VRE Y2 
YSAV 


FORT III III IOI IIGIOIGIDIDIDIGIGIGIGIGIGIGIGIGIGIGIGICISIS I tr 


Kak KK 
kak 


RRR KAKA KKIKKKKKEKKK KKK KAR 


KARR EK IK KK 


* 
* 
kh 
* 


WK KK TIO KK RIK 


* 
kkk 
KARE 
ak kK 
Kae 


KERR 


* 
x 


KAKKKKKKKKK 


KR RK RK RIK KKK KR KIRKE KERR KEE KERR KK KEKE 
RRR KKK AA KKK ERK ROR RO Rokk Rk kK RO OK a Oa ak 


RkKKKKK 


KKK KK 


KKKKKKE 
IO 


FOR IOI 


ae 
Rk 
* 

ak 


FORO OI TIO 


RRR EK K KKK KKEKKK KKK R KM ARKAKKAKEKR KE KR RAE 


kkk 


FR TO RIOR RII KR III EKER KEK ER RK KKK KEK EK 


kkk 
kkk 
x 
kkK 


* 


* 


GETLN 
HOOKS 
INBUF 
KBD 
KEYIN3 
KSWL 
LFA36 
MODES 
MOVNXT 
NOTCR 
NXTASCI 
NXTCHR 
PCH 
PRAIBYTE 
PRHEX 
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Minimum frequency 
Maximum frequency 
Average frequency 
Unused opcodes: 
BRK CLI CLV NOP ROR SED 


Program opcode usage: 89 & 


(1.80) That's all, Folks ... 
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1 INTRODUCTION 


This document provides a general overview of the contents of the Apple H/T 
computer ROM revision 1. This information should be used in conjunction with a 
copy of the ROM source code listing. The audience of this document is anyone 
with an interest in the technology of the Apple /// computer’s hardware and 
software. 


NOTE 
There were two revisions of the Apple /// ROM, revision 0 and revision 1. 
Revision 0 ROMs had at address FiB$ the value 60. Revision 1 ROMs had at 
address F1B9 the value AQ. 


This ROM contains 4 KB of 6502 programming and several data tables. The ROM 
occupies memory addresses FOO0-FFFF. The basic purpose of the ROM is to test 
the Apple /// computer hardware and boot an operating system from the ///’s 
built-in floppy disk drive. The ROM also contains a simple Monitor program whose 
purpose is to allow the user to interact with the /// at the hexadecimal level. 


Apple planned from an architectural perspective to support two 4K ROMs. But 
only one ROM was ever created. The Environment Register let you control which 
ROM was active. Both ROMs shared the same address space so you could only 
have one ROM active at a time. This feature would have doubled the ROM’s 
effective size providing Apple with more room for ROM-based features that higher- 
level /// software (e.g. SOS) could have used. 


When the Apple /// computer is turned on the ROM’s flow of execution is as 
follows: 
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The ROM starts execution at the address contained in FFFC-FFFD (RESET) which is 
address F4EE (DIAGN). 


Diagnostics (DIAGN/F4EE) starts. The diagnostic first initializes some memory for the 
ROM’s use. If the Open Apple and the Control keys are held down then enter the ROM 
Monitor. Otherwise run several diagnostic checks of the /// hardware (tests zero 
page, sizes memory, initializes screen text buffer, tests stack memory, tests ROM 
checksum, tests VIA chip, tests ACIA chip, tests A/D circuitry, tests keyboard 
connection). Any diagnostic failures display an error message and the user has to 
reset the computer. 


Read block 0 (512 bytes) to address A000 from the floppy disk in the built-in disk drive 
(BOOT/F6A1). If no disk is found or block 0 cannot be read then display “RETRY” and 
wait for the user to reset the computer. If the block is successfully read then execute 
the block contents (this is called the SOS Bootstrap Loader: see section ROM USAGE BY 
sos). 


2 ROM SECTIONS 


Section Address Purpose 


Disk 1/0 FO000-F4C4 Read and write floppy disk blocks (512 bytes each) 
Diagnostics F4C5-F7FE Diagnose the /// hardware 
Monitor F7FF-FFFF Interacts with user so user can do simple things 


3 IMPORTANT ROM ROUTINES 


BLOCKIO / F479 Reads or write a disk block (512 bytes), calls routine REGRWTS (F000) 
which reads a sector (256 bytes) from the disk. 


BOOT / FoA1 Read floppy disk block *0 into address A000, execute the block. 
ENTRY / F901 Monitor entry point. 
DIAGN / F4EE Diagnostic entry point. 


USRENTRY/F6E6 Tests RAM and displays a table showing chip failures (users may execute 
this routine from the Monitor). This test is aimed at Apple ///s with 
128K of RAM that exists on the older 12-Volt RAM boards. Though this 
routine will work with the newer 5-Volt RAM boards (256K) this test 
shows wrong information when RAM errors occur since the two RAM 
boards contain a different number of RAM chips. You can identify the 
different RAM boards as follows: The 5V boards have a large gray 
ceramic resistor near the edge and the 12V boards have a smail blue 
tubular capacitor. To test the ///’s RAM you really should use Apple’s /// 
Diagnostics Disk which lets you specify which RAM board you have. 


4 ROM TABLES 


Here’s a list of the important data tables in the ROM. This list does not include 
disk 1/0 tables. 
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Table Name / Address Contents 


er i A i 


CHRSET / FEC5-FFB3 Default character set (overridden when SOS loads the character 
set from SOS. DRIVER) 


Copyright / FFCO-FFEF Copyright message (contains the initials “JRH” for J. R. “Dick” 
Huston who was a key player behind the /// and SOS) 


NMI / FFFA-FFFB Jump address for the Non-Maskable Interrupt signal 
RESET / FFFC-FFFD Jump address when the /// is powered on 


IRQ / FFFE-FFFF Jump address for the Interrupt Request signal 


es SSS 


5 ROM USAGE BY SOS 


The Apple /// operating system (SOS = Sophisticated Operating Systern or Sara’s 
OS) uses several ROM routines. These routines seer to all be related to disk block 
1/0. The following discussion is based on SOS version 1.3. 


When the ROM loads block 0 from a SOS disk the ROM is loading the SOS Bootstrap 
Loader program. This program, which is at most 512 bytes in length, uses the 
ROM routine REGRWTS (F000) to read the SOS Loader into memory. This program 
does not test the ROM revision. It is interesting to note that ROM routine BLOCKIO 
is not used, instead a lower-level routine (REGRWTS) is used. 


The SOS Loader determines if the ROM is revision 1 by comparing address F1B9’s 
contents against AO (reference: SOS source file SOSLDR.D.SRC). If this comparison 
fails then SOS displays on the screen the error “ROM ERROR: PLEASE NOTIFY YOUR 
DEALER.” If the ROM revision is correct then the SOS loader uses the ROM’s disk 
1/0 routines to read more of SOS into memory. 


The disk /// driver that is built into SOS also uses the ROM to perform disk block 
1/0 (reference: DISK3.SRC). It is interesting to note that when the disk driver is 
initialized the driver checks if the ROM revision is 0 or 1. A revision of 0 is 
detected if address FiB9 contains 60. If neither revision is found then the disk 
driver returns an error to SOS (I don’t think this will ever happen since the SOS 
loader has already determined that the ROM is revision 1). For a valid ROM 
revision the disk driver sets up several jump vectors which point to the 
appropriate addresses in the ROM for the various ROM routines needed by the disk 
driver. Therefore, the disk driver seerns compatible with either ROM revision 
whereas the SOS loader likes only revision 1. 


The .CONSOLE driver source listing appears to not use any ROM routines even 
though the ROM contains 40 and 80 column text routines and keyboard input 
routines. I assume the console driver was much more sophisticated than the 
ROM’s text features and so using the ROM routines would not have worked well for 
this driver. I also assume that if the console driver used the ROM that when ROM 
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revision 1 was built the console driver would have had to be changed and Apple 
(smartly) did not want to do this. 


6 MONITOR COMMANDS 


Holding down the Open Apple and Control keys when the /// starts or when you 
press the Reset key activates the /// ROM Monitor. The screen will display in the 
upper left corner a small right-facing arrow with a blinking underscore character 
as the cursor. The Monitor’s commands are based on the Apple ][‘s Monitor 
commands but some commands have changed slightly and others are new for the 


(newer) ///. 


The Monitor supports the following commands: 


addril.addr2 Dump memory data to screen from address 1 to address 2 and display 
ASCII character at the right of the screen. 


CARRIAGE RETURN Dump next line of addresses to the screen. 
SPACE Pause current memory dump. Press again to continue. 
addr: byte_list Store starting at the address the list of bytes. 
addr:’text’ Store text starting at address with high bit clear. 
addr: text” Store text starting at address with high bit set. 
addr3<addril.addr2M Move data in addresses 1-2 to address J. 
addr3<addri.addr2V Verify data in addresses 1-2 is the same as data starting at address 3. 
byte<addri.addr28 Search memory in address range 1-2 for the byte. 
block<addri.addr2W Write address range to disk starting at the disk block. 
block<addri.addr2R Read disk starting at block to the address range. 
addrG Call subroutine at the address. 
addrJ Jump to the address. 
Call user routine starting at address $03F8. 
Repeat last command line until you press the SPACE BAR. 
Display 80 columns of text. 
Display 40 columns of text. 
Seperate multiple commands on the same line. 


Interrupt current operation, return to Monitor command line. 
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Note: See Wells’ Apple “// Entry Points article for a great overview of the ROM 
Monitor, its commands (with some syntax errors), and the memory 
locations that need setting up for the key ROM routines to work. Apple’s 
ti) Service Reterence Manual (p. 13.57) has a list of Monitor commands. 
Anderson’s Zhe Apple Nobody Knows also has good Monitor command info. 


To obtain a binary dump of the /// ROM you can do the following: 


. Initialize a disk on either the /// or an Apple ][ computer. 

. Insert the new disk in the ///. 

. Start the /// and hold down the Open Apple and Control keys. 

. You should be in the /// Monitor. 

. Type 0<F000.FFFW to write the ROM to disk blocks 0 to 7 

. Use a disk block reader on the /// or the J[ to read the ROM blocks and save 
them to a real file. 


This disk writing is needed since the ROM does not provide a command for 
redirecting screen output to the ///’s serial port. But, I’ve read that you can 
output the ROM contents to the ///’s serial port but this involves using the Monitor 
to write a small program. If anyone has such a program please send a copy my 
way. 


7 A FEW COMMENTS 


1 find it interesting, at least from a software engineering perspective, to note that 
in my opinion the /// ROM is missing several key features which I thought any 
system ROM would need. The ROM is missing two features which I think would 
have been useful to Apple and outside /// programmers: 


1) The ROM does not have an explicit version number which exists at a specific ROM 
address. This version number could he used to validate the ROM in case there were 
several different ROMs (as there were). Apple uses a pseudo ROM version number 
(called the revision number) during the loading of SOS but this is somewhat lame in 
my opinion. 


The ROM does not have a dispatch routine for use by the OS or applications that want 
to use ROM routines. This dispatch routine would reside at a specific address (e.g., 
F000) and it would take as input a command number and a set of parameters. These 
parameters could be passed via registers or on the stack. This routine would allow 
Apple to change the ROM and ROM “users” would not need to change their 
programming as long as they used the selector routine. The Apple |[ ROM did not have 
such a routine which caused Apple many headaches when it wanted to change the 
Apple ][ ROM and had to keep lots of routines in their same place. 


The ROM source code is rather sparse concerning comments. It would be nice if the 
ROM contained detailed information about what each routine did and how to call the 
routines. Obviously, Apple did not expect anyone but Apple’s own programmers to 
ever see the ROM source or use the ROM routines. (I’ve seen the Lisa computer’s ROM 
listing which is much better documented than the ///’s and both are comparable in 
terms of age). 
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8 REFERENCES 
Apple /// ROM Listing - Revision 0 


This can be found in the Apple /// patent (#4,383,296) dated May 1983. Note that 
in places this ROM listing is not always readable. 


Apple /// ROM Listing - Revision 1 


I have a very readable listing of the revision 1 ROM that was printed on a laser 
printer. 


Apple /// Service Reference Manual (Level 2) 


This almost 500 page document by Apple has everything you would want to know 
about the ///’s hardware, low-level software, and how to service a broken ///. 
Includes descriptions of the System Monitor (a.k.a. Development Monitor) [page 
17.3] and the built-in RAM test routine [page 13.51]. 

Apple {4/7 SOS Bootstrap Loader Listing 


Shows how 512 bytes of code are used to load SOS from disk into the ///’s 
memory. 


The following articles provide good ROM information: 
Apple /// Entry Points, Andy Wells, Call-APPLE, October 1981 
Apple /// Dabbling, Rick Smith, Apple Orchard, Summer 1981 
M// Bits: John Jeppson’s Guided Tour of Highway //4 Sonn Jeppson, Softalk, May 1983 
The Apple Nobody Knows, Alan Anderson, Apple Orchard, Fall 1981 
Uniocking the Apple /// - Part % Alan Anderson, Apple Orchard, September 1982 
Apple {f/f 12-Valt 128K Internal Diagnostics, Apple Technical Information Library 

9 DOCUMENT MODIFICATION HISTORY 

30 Nov 1997 Created this document. 


04 Dec 1997 Corrected a few problems, extended the Reference section to 
include more /// articles pertaining to the /// ROM, added this 
section, added section MONITOR COMMANDS. 
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i INTRODUCTION 


This document provides a general overview of the contents of the Apple /// 
computer ROM revision 1. This information should be used in conjunction with 
a copy of the ROM source code listing. The audience of this document is anyone 
with an interest in the technology of the Apple /// computer’s hardware and 
software. 


NOTE 
There were two revisions of the Apple /// ROM, revision 0 and 
revision 1. Revision 0 ROMs had at address F1B9 the value 60. 
Revision 1 ROMs had at address F1B9 the value AO. 


This ROM contains 4 KB of 6502 programming and several data tables. The ROM 
occupies memory addresses FOO0-FFFF. The basic purpose of the ROM is to test 
the Apple /// computer hardware and boot an operating system from the ///'s 
built-in floppy disk drive. The ROM also contains a simple Monitor program 
whose purpose is to allow the user to interact with the /// at the hexadecimal 
level. 


When the Apple /// computer is turned on the ROM’s flow of execution is as 
follows: 


1) The ROM starts execution at the address contained in FFFC-FFFD (RESET) 
which is address F4EE (DIAGN). 


2) Diagnostics (DIAGN/F4EE) starts. The diagnostic first initializes some 
memory for the ROM’s use. If the Open Apple key is held down then enter 


the ROM Monitor. Otherwise run several diagnostic checks of the /// 
hardware (tests zero page, sizes memory, initializes screen text buffer, 
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tests stack memory, tests ROM checksum, tests VIA chip, tests ACIA chip, 
tests A/D circuitry, tests keyboard connection). Any diagnostic failures 
display an error message and the user has to reset the computer. 


Read block 0 (512 bytes) to address A000 frorn the floppy disk in the built- 
in disk drive (BOOT/F6A1). If no disk is found or block 0 cannot be read 
then display “RETRY” and wait for the user to reset the computer. If the 


block is successfully read then execute the block contents (this is called the 
SOS Bootstrap Loader: see section ROM USAGE BY SOS). 


2 ROM SECTIONS 


Section Address Purpose 


Disk 1/0 FO00-F4C4 Read and write floppy disk blocks (512 bytes each) 
Diagnostics F4C5-F7FE Diagnose the /// hardware 

Monitor F7FF-FFFF Interacts with user so user can do simple things 
3 IMPORTANT ROM ROUTINES 


BLOCKIO / F479 _—- Reads or write a disk block (512 bytes), calls routine REGRWTS 
(F000) which reads a sector (256 bytes) from the disk 


BOOT / F6A1 Read floppy disk block *0 into address A000, execute the block 
ENTRY / F901 Monitor entry point 
DIAGN / F4EE Diagnostic entry point 


USRENTRY/F6E6 Tests RAM and displays a table showing chip failures (users 
may execute this routine from the Monitor) 


4 ROM TABLES 


Here’s a list of the important data tables in the ROM. This list does not include 
disk I/O tables. 


Table Name / Address Contents 


CHRSET / FEC5-FFB3 Default character set (overridden when SOS loads the 
character set from SOS.DRIVER) 


Copyright / FFCO-FFEF Copyright message (contains the initials “JRH” for J. R. 
Huston who was a key player behind the /// and SOS) 


NMI / FFFA-FFFB Jump address for the Non-Maskable Interrupt signal 


RESET / FFFC-FFFD Jump address when the /// is powered on 
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IRQ / FFFE-FFFF Jump address for the Interrupt Request signal 
5 ROM USAGE BY 505 
The Apple /// operating system (SOS) uses several ROM routines. These routines 


seem to all be related to disk block I/O. The following discussion is based on SOS 
version 1.3. 


When the ROM loads block 0 from a SOS disk the ROM is loading the SOS 
Bootstrap Loader program. This program, which is at most 512 bytes in length, 
uses the ROM routine REGRWTS (F000) to read the SOS Loader into memory. 
This program does not test the ROM revision. It is interesting to note that ROM 
routine BLOCKIO is not used, instead a lower-level routine (REGRWTS) is used. 


The SOS Loader determines if the ROM is revision 1 by comparing address F1B9’s 
contents against AO (reference: SOS source file SOSLDR.D.SRC). If this 
comparison fails then SOS displays on the screen the error “ROM ERROR: PLEASE 
NOTIFY YOUR DEALER.” If the ROM revision is correct then the SOS loader uses 
the ROM’s disk I/O routines to read more of SOS into memory. 


The disk /// driver that is built into SOS also uses the ROM to perform disk block 
1/0 (reference: DISK3.SRC). It is interesting to note that when the disk driver is 
initialized the driver checks if the ROM revision is 0 or 1. A revision of 0 is 
detected if address F1B9 contains 60. If neither revision is found then the disk 
driver returns an error to SOS (I don’t think this will ever happen since the SOS 
loader has already determined that the ROM is revision 1). For a valid ROM 
revision the disk driver sets up several jump vectors which point to the 
appropriate addresses in the ROM for the various ROM routines needed by the 
disk driver. Therefore, the disk driver seems compatible with either ROM 
revision whereas the SOS loader likes only revision 1. 


6 A FEW COMMENTS 


I find it interesting, at least from a software engineering perspective, that the 
ROM is missing some key features which I thought any system ROM would need. 
The ROM is missing two features which I think would have been useful to Apple 
and outside /// programmers: 


1) The ROM does not have an explicit version number which exists at a 
specific ROM address. This version number could be used to validate the 
ROM in case there were several different ROMs (as there were). Apple uses 
a pseudo ROM version number (called the revision number) during the 
loading of SOS but this is somewhat lame in my opinion. 


The ROM does not have a selector routine for use by the OS or applications 
that want to use ROM routines. This selector would reside at a specific 
address (e.g., F000) and it would take as input a command number and a 
set of parameters. These parameters could be passed via registers or on 
the stack. This routine would allow Apple to change the ROM and ROM 
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“users” would not need to change their programming as long as they used 
the selector routine. The Apple ][ ROM did not have such a routine which 
caused Apple many headaches when it wanted to change the Apple ][ ROM 
and had to keep lots of routines in their same place. 


7 REFERENCES 


Apple /// ROM Listing 


I have a very nice listing of revision 1 ROM. A listing (that is somewhat 
readable) for the earlier revision 0 ROM may be found in the Apple /// patent. 


Apple /// Service Reference Manual (Level 2) 
This almost 500 page book by Apple has everything you would want to know 
about the ///’s hardware, low-level software, and how to service a broken ///. 


Includes descriptions of the System Monitor (a.k.a. Development Monitor) [page 
17.3] and the built-in RAM test routine [page 13.51]. 


Apple /// SOS Bootstrap Loader Listing 


Shows how 512 bytes of code is used to load SOS from disk into the ///’s 
memory. 


FH 
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Apple /// Computer Technical Information 


SOME COMMENTS ABOUT THE 
APPLE /// COMPUTER BOOT ROM 


David T Craig -- 27 February 2004 


BACKGROUND 


The Apple /// computer was introduced by Apple Computer in 1980 and was 
discontinued in 1985. 


This computer was a microcomputer with orginally 128 KB of RAM memory 
expandable to 256 KB of RAM. It featured a 4 KB ROM (addressed from $F000 to 
SFFFF hexadecimal) which housed the initial programming that executed when 
the user turned on the computer. This ROM contained programming for the 
following functions: 


+ diagnose hardware circuitry and memory 
+ load and run a disk operating system (i.e. "boot") 
+ provide an interface to a simple monitor program 


The author wrote these comments after looking at the Apple /// ROM listing as 
found in Apple Computer's patent number 4,383,296 dated 10 May 1983. This 
analysis occured during a scanning of the Apple /// patent. 


ROM COMMENTS 


The Apple /// patent's ROM program listing is terrible in terms of printed 
quality. Many parts are very faint and impossible to read. | assume this was 
done on purpose by Apple's legal department so that Apple's competitors would 
not be able to duplicate this ROM programming easily. 
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The ROM programming does not seem to have been built for expansion. By this | 
mean the programming seems to have been written to just make it work and no 
long term thought was given to the ROM programming's organization. 


There were two versions of the ROM. The Apple /// operating system (OS) 
programming needed to differentiate between the ROM versions since the ROM 
contained several routines which the OS used. This version determination was 
not done in a logical way. A memory location was chosen at random (at least it 
seems this way to me) to serve as the ROMs “version number". The OS had to 
test this “version number” when it needed to use specific ROM services. 


The ROM version also determined the location of several ROM routines which 
the Apple /// OS used. 


The ROM's organization could have been improved greatly in my opinion if it 
was organized differently. At the beginning of the ROM address space ($F000) 
include a short header containing the following: 


SFO00 - ROM version number 

SF001 - ROM size (K bytes) 

SF002 - ROM checksum (2 bytes) 

$F003 - ROM routine dispatch jump vector (3 bytes) 


SFO006 - ROM copyright notice (e.g. "(c) Apple Computer 1980") 


The remainder of the ROM would have contained whatever programming and 
table data was needed. 


The routine dispatch jump vector would be a standard jump instruction to a 
routine in the ROM whose purpose would be to let outside programs such as the 
operating system, device drivers, or even application programs access ROM 
routines in a ROM version independent manner. The dispatch routine would 
take as input a command number (in say the CPU's A register) and return result 
information in the CPU's X and Y registers. The A register on return would 
contain an error result with 0 meaning no error. Or, some fixed memory area 
could be use to handle ROM routine parameters. This dispatch mechanism 
could be seen as a BIOS (basic input output system). 
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Possible dispatch routines could be: 


Restart or Cold start or Warm start the computer 
Read a block from a disk drive 

Write a block to.a disk drive 

Return size in blocks of a disk drive 

Checksum the ROM for diagnostic purposes 

Test computer's RAM memory for diagnostic purposes 
Enter the Apple /// Monitor program 


This dispatch mechanism would have simplified the Apple /// OS use of the 
ROM services since the ROM would always be accessed from just one address 
(SFO03). If the OS requested a ROM service which was unavailable (e.g. an old 
ROM was installed) then the ROM would tell the OS that the service did not 
exist via a dispatch error result. 


CONCLUSION 


Hopefully this little commentary provides some useful information to its 
reader. If you are interested in the Apple /// computer you should see its 
patents (one is for the Apple ///, the other is for the Apple /// Plus). The first 


patent contains the full ROM listing, but the author has a real digital copy 
which is much more readable. 


Enjoy. 
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Added several good comments by Chris Smolinski (he's writing a /// emulator called 
SARA) . 
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DISK IMAGES: Updated info about DTCMake3///DiskImage Mac application, made disk image 
file an all-text file. 

SOS SYSTEM CALL EMULATION: typo Silentypr --> Silentype. 

WHAT TARGET MACHINES SHOULD BE SUPPORTED: More pre-68040 Mac comments. 

EMULATOR DEBUGGING FACILITIES: typo affects --> affect, added info about 
enabling/disabling SOS BRK disassembly, same for ProDOS, added list of emulator 
debugging commands. 

EMULATOR MEMORY STRUCTURE: New section. 


12 Dec 1997 -- Version 4 


EMULATOR DEBUGGING FACILITIES: Added examples to every debugging command. Added 
commands SNAPSHOTW, SNAPSHOTR, ZPAGE, SPAGE, EPAGE, DRIVERS, macro commands. 
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1.0 PURPOSE 


This document describes some ideas about implementing a software emulator for the 
Apple /// computer. These ideas are based on my experiences with the Apple /// 
computer and its software programming. No specific target machine is mentioned in 
this document since these ideas should be non-target machine specific. These ideas 
are submitted to stimulate thought about such an emulator and hopefully inspire 
someone to produce a working Apple /// emulator. 


The technical details behind the Apple /// computer, its operating system (SOS), and 
/// programs (e.g. AppleWriter ///) are based on my extensive collection of /// 
technical manuals, specification sheets, and many /// technical articles (Dr. John 
Jeppson's articles are very exhaustive and full of lots of neat /// techoid stuff). 
I have around 15 Apple manuals, the majority of which were published by Apple, which 
include user manuals and the technical programming manuals. 


For those people seriously interested in implementing an Apple /// emulator program I 
highly recommend that they have at least the Apple /// Service Reference Manual. 

This manual, which is almost 500 pages long, is the definitive reference for how the 
Apple /// computer works. Most of its contents describe theory of operation even 
though its title suggests service-type information only. The important features of 
this manual for a /// emulator writer are the /// memory map and the /// memory 
mapped I/O locations. 


I also own an Apple /// computer which still today works very well. I programmed the 
/// Many moons ago and have worked professionally as an Apple Macintosh computer 
programmer since 1984. 


Note: All comments are welcome. If you have anything to add or correct please let me 
know and I will update the master copy of this document. 


2.0 EMULATOR GOALS 


The /// emulator should provide a complete emulation environment for the faithful 
execution of Apple /// and /// Plus programs. As far as the emulator user is 
concerned when they run the emulator program their computer should work just like an 
Apple /// computer and all /// visual fidelity should be maintained. Emulation of 
the Apple /// Plus computer may also be supported (this means the /// Plus’ 
interlaced screen). If the /// Plus is supported by the emulator you may want to let 
the user specify if they want to runa /// or a /// Plus. 


I think it would be beyond neat if the emulator could run Apple's running horses demo 
and the other /// demos. 


The /// emulator should support an Apple /// computer with at least 256K of memory 
and four floppy 140K disks (.D1, .D2, .D3, .D4). Support for 512K of memory may also 
exist since the ///'s operating system (SOS) supports up to 512K of memory. Memory 
size, if variable, should always be a multiple of 32K. I believe the lowest memory 
size supported by the /// (ROM?) is 96K. Support for a ProFile disk may also exist 
(for this disk there would need to be a disk image with a size of 5M). The first 
floppy disk (.D1) would correspond to the floppy disk drive that is built into the 
Apple ///. The other disks correspond to external disks and should exist as image 
files with specific file names (e.g. "Apple 3 D1", "Apple 3 D2", etc). The ProFile 
disk image file should also have a specific file name (e.g. "Apple 3 ProFile"). 


Image file names should have an extension (e.g. ".D3I") since this is needed by PCs. 
3.0 EMULATOR USER INTERFACE 

When the user runs the Apple /// emulator program the user should see on their 
computer screen a screen (or a window representing the screen on GUI systems) 


corresponding to the ///'s screen which the user would see if they were in front of a 
real Apple /// computer. All /// text and graphic modes should be supported by the 
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/// emulator (this includes the special modes supported by the /// Plus and its 
interlaced screen architecture). 


I recommend that the emulator also support a screen dump facility that writes the 
current /// screen to either a text file (for text modes) or to a graphic file (for 
graphic modes) or always just creates a graphic file. The screen dump graphic file 
should be a standard graphic file for whatever target machine your support (e.g. on 
the IBM PC running Windows produce .BMP files, on the Apple Macintosh produce PICT 
files). Since the /// supports custom character sets dumping the screen to a PICT 
file (or to the target computer's clipboard) may be the best solution. 


The emulator screen if implemented in a GUI window may also display a status area at 
the bottom of the window. This status area would display at least two lines of text 
and would keep the user informed of what the emulator was doing internally. 


4.0 DISK IMAGES 


The /// emulator should read disk image files which correspond directly to real /// 
140K disks. When the /// emulator starts it should look in its folder and if there 
exists a /// disk image file the emulator should boot this image. If there are 
multiple disk image files then the emulator may want to display a list of these 
images and have the user select an image to boot. 


The disk images should be exact copies of real /// disks. To make copies of these 
disks there should exist an utility program that runs on the /// computer and which 
outputs disk block data to the /// serial port (I plan to make this utility and call 
it DTCcDumpIt). This utility's output should be a hex/ascii dump that specifies block 
numbers and has a checksum for each line of data. This utility should ask the user 
if it should dump a file or a disk. 


On the target machine there should exist a similar utility that inputs the disk block 
data and creates a disk image file. I recommend that the transmitted disk block data 
consist of a hex dump with block number and checksum information in a human readable 
fashion. The receiving program (on the target computer) would read this human 
readable information, verify that the data was sent correctly, and produce binary 
disk image file images (I plan to create this utility for the Apple Macintosh and 
call it DTCMake///DiskImage). 


There should also exist a disk image file for the ///'s Boot ROM (recommended file 
name: "Apple 3 Boot ROM"). This image should contain the 4K ROM image. This ROM 
should be the Revision 1 ROM (not Revision 0) since this was the last ROM produced 
and SOS 1.3 (the last SOS) requires this ROM. 


Users should also be able to format a disk image by specifying the disk drive device 
mame (e.g. .D2). Users should then be able to name the disk image so that they can 
use it later. Users should be able to assign specific disk images to specific disk 
drives. 


I recommend that all disk image files have a very specific internal format. This 
format should support the verification of disk image files so that if a disk image 
file becomes corrupted in some fashion the /// emulator can detect this corruption, 
not use the image, and alert the user. 


Note: Support for existing Apple ][ disk image files may be feasible but I recommend 
against this since the format of these images could change. 


The proposed image format: 


The disk image file contains two parts, a header part and a data part. The header 
part appears first followed by the data part. The header part contains 
identification and verification information. The data part contains the actual disk 
blocks for the /// disk. This file contains only text, no binary data appears here 
in any fashion. The only non-text information that can appear in these files is the 
Carriage Return (CR) and the Line Feed (LF) characters. The emulator should ignore 
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All information appears in lines with a maximum length of 255 
Blank lines are ignored. The reason for 


this format is so these image files can be transferred over the internet without the 


need for any binary-to-text conversion. 


Also, text-only files can easily be viewed 


by people using a word processor. 


The header part contains: 


Signature 
Version 
Image Name 


Creation Date 
Created by Name 
Comment 

Data Size 

Data Checksum 
Reserved 1 
Reserved 2 
Reserved 3 
Reserved 4 

Tech Comment 


Comments 


"APPLE /// DISK IMAGE" 

"VERSION" version number (e.g. "1") 

“IMAGE NAME" name of image, anything the user wants, 
most likely the name of the interpreter on the disk, 
e.g. "Apple Writer ///" 

"CREATED" date image file created, "YYYY-MM-DD" 
"CREATED BY" name of person or company who created this image 
"COMMENT" comment for anything user wants 

"DATA SIZE" size of data part (decimal, e.g. "143360") 
"DATA CHECKSUM" hexadecimal checksum (e.g. "FA7C3188") 
"RESERVED" 

"RESERVED" 

"RESERVED" 

"RESERVED" 

"TECH COMMENT" name of program that this is for 


Header Checksum "HEADER CHECKSUM" hexadecimal checksum (e.g. "B97C31D5") 


Notes: 


The checksum should be calculated as the exclusive-OR of each byte followed by a left 
rotation of 1 bit. Checksum starts with zero. Checksums should always be 4 bytes in 
size and be stored in the header as an 8 character string. 


The Tech Comment's purpose is to allow people who obtain an image file to be able to 
contact someone about the file's purpose. 


The data part contains lines representing 16 bytes from the original disk. Each line 
has a specific format which begins with the starting disk address for the line, 16 
bytes, the ASCII equivalent of the 16 bytes, and a checksum for the bytes of the line 
with the format: 


[00000000] 0123 4567 89ab cdef 0123 4567 89ab cdef [1234567890123456] 12345678 


The last line of the file must be the word "FINIS". 
Sample disk image file: 


APPLE /// DISK IMAGE 
VERSION 1 

IMAGE NAME Apple Writer /// 
CREATED 1997-10-11 

CREATED BY David T. Craig 
COMMENT Thanks to Paul Lutus 
DATA SIZE 16 

DATA CHECKSUM FA7C3188 
RESERVED 

RESERVED 

RESERVED 

RESERVED 

TECH COMMENT For David Craig's /// Emulator - 71533.606@compuserve.com 
HEADER CHECKSUM B97C31D5 


[00000000] 0123 4567 89ab cdef 0123 4567 89ab cdef [Apple.///.Emul..] FA7C3188 
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FINIS 
5.0 6502 CPU EMULATION 


The heart of the /// emulator should be the emulation of the 6502 CPU. The heart may 
be referred to as the "6502 engine." The emulator should support all of the 6502 
instructions, the 6502 registers, and the special Apple /// registers (e.g. the bank 
switch register, the environment register, and the zero-page register). Special 
register descriptions and usage can be found in the Apple /// SOS Reference Manual. 


The 6502 engine must be smart about accessing memory and use the bank switch and 
environment registers correctly. 


If this level of the /// emulation is complete and robust the rest of the /// 
emulator should work much more easily. 


Support for special /// features may also exist at this level of the /// emulator. 
For example, the /// emulator may not want to emulate all of the ///'s memory-mapped 
T/O features, but instead intercept access to special areas or routines and call the 
target machine's operating system to handle these features. See sections ROM 
EMULATION and MEMORY-MAPPED I/O EMULATION for more details. 


6.0 ROM EMULATION 


The /// emulator should also support as much as possible the ///'s Boot ROM. This 
means the Boot ROM's routines should work for the most part as-is. 


Note: I have a listing of the Boot ROM which could be useful for this emulation 
discussion. 


For the Boot ROM's floppy disk I/O support I recommend that all the gory details here 
not be supported directly at the memory-mapped I/O level but instead the /// emulator 
should emulate this I/O. Specifically, the /// emulator should intercept any access 
to the Boot ROM routines which read or write disk blocks and use the appropriate 
target machine operating system routines to accomplish this feature. 


The /// emulator should also initialize the ROM's character set which the ROM 
normally loads into a special RAM chip that is not accessible to the ///'s 6502 
processor. See section MEMORY BANK SWITCHING EMULATION for more details. 


7.0 MEMORY - MAPPED I /O EMULATION 


All memory-mapped I/O locations that in some way deal with the physical world need to 
be handled by the /// emulator. These areas include such addresses as the speaker 
addresses. The Apple /// Service Reference Manual provides detailed information 
about these addresses. 


All accesses to memory by the /// emulator must respect the bank switch and 
environment register settings so that the emulator does not try to access a memory- 
mapped address when that address is not mapped into the 6502 address space. 


Programs which access low-level I/O locations such as the disk I/O addresses should 
not be supported. I assume most /// programs will access hardware components using 
SOS or device drivers. 


Note: Chris Smolinski says that emulating the low-level stuff on a Power PC-based 
Macintosh is not very difficult and works rather fast (he's implemented in his SARA 
emulator the ///'s floppy disk I/O). 

8.0 MEMORY BANK SWITCHING EMULATION 

The /// emulator must also fully support the ///'s bank switched and enhanced 


indirect addressing memory architecture. Detailed descriptions and usage of /// 
memory handling can be found in the Apple /// SOS Reference Manual. 
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The /// emulator should also support the ///'s character set RAM chip. This holds 
the bitmap descriptions of each of the 128 characters in the /// character. This RAM 
area, which is not accessible to the ///'s 6502 CPU, holds 1024 bytes. See the Apple 
/// Standard Device Drivers Manual (Console Character Sets section) for more 
information. 


Note: I believe the storage of the Boot ROM character set is different than the 
storage of the character set in the SOS.DRIVER file. I believe the ROM character set 
has bits that are reversed compared to the SOS.DRIVER character set. 


The storage of text and graphics in memory should be supported also. This should 
happen automatically when a /// program writes to the text/graphic memory buffers. 
The emulator needs to detect such writes and update its screen as appropriate. 


9.0 SOS SYSTEM CALL EMULATION 


The majority of system calls to SOS and its drivers should most likely not be 
intercepted by the /// emulator. But certain calls may need to be intercepted unless 
a lower level of the /// emulator intercepts these feature already. System calls to 
SOS or drivers that may need intercepting by the /// emulator could be: 

Disk I/0 (.D[1-4] and .PROFILE drivers) 
Keyboard 1/0 (.CONSOLE driver) 
Screen I/0 (.CONSOLE and .GRAPHIC drivers) 
Sound generation (.AUDIO driver) 
Serial port I/0 (.RS232 driver) 
Silentype Printer (.SILENTYPE) [I'm not sure about support for this] 
Clock I/0 (Y2K dates may be a problem) 


I recommend that the /// emulator intercept all activity dealing with the above and 
have the target machine perform the equivalent features. For example, to read or 
write a disk block the /// emulator should have a routine that accesses the 
appropriate location in the disk image file. 


The /// emulator may also provide the user with some type of setup options so that 
the user can specify specific properties of some of the above drivers. For example, 
if the target machine supports several output ports the emulator may let the user 
specify which port to use (e.g. for the .PRINTER driver the user could assign it to a 
specific serial or parallel port on the target machine). 


Note: The ///'s clock does not support the year 2000 or greater. I think the 
emulator should support Y2K dates but I'm not sure if SOS's file system date stamps 
will support this easily. 


10.0 DEVICE DRIVER EMULATION 


This section is for the most part handled by my comments in section SOS SYSTEM CALL 
EMULATION. I suspect the programming within the /// emulator for this area could be 
the most work since there are lots of device drivers that make up a simple Apple /// 
configuration. 


One area of device drivers that the /// emulator may not want to emulate is interrupt 
handling. Since the emulator does not have physical devices connected to it in any 
direct fashion I don't think interrupts exist as far as the emulator is concerned. 
Interrupts dealing with disks or the keyboard can be handled at a lower level by 
having the /// emulator call the appropriate system call in the target machine. 

These low-level I/O handlers should set up the appropriate driver data areas so that 
the rest of the ///'s software (SOS and the interpreter) will work correctly. For 
example, keyboard I/O should be setup in the /// emulator so that when the keyboard 
input memory-mapped I/O location is accessed the target machine OS really reads the 
keyboard and sets up the memory-mapped location as appropriate. 


11.0 KEYBOARD SUPPORT 


Some Ideas about an @ Apple /// Computer Emulator ~- Version 4 
David T Craig -- 12 Dec 1997 - 6/23 


COOCCSSCSCSCSCSCSCSCSC*S Page OTA OF OTT 


Apple Computer Inc. Patent : 4 383 296 


ale se User interface support 


The /// computer's keyboard layout is basically compatible with modern keyboards. 

The /// keyboard does have two extra keys, Open Apple and Closed Apple which are 
positioned to the left of the Apple /// keyboard. Also present on the keyboard are 
four arrow keys. The emulator should support these keys either directly (i.e., the 
target machine has similar keys) or associate other keys with the ///'s special keys 
(e.g., the Macintosh computer's two Option keys could be used to simulate the special 
Open and Closed Apple keys). The emulator's associated keys need not physically be 
in the same location as the ///'s special keys but having them in the general area 
will be beneficial. 


Note: The /// Plus keyboard contains an extra key, Delete, compared to the /// 
keyboard. 


11.2 Low-level access 


The /// emulator should handle low-level access to the keyboard memory-mapped 1/0 
locations as detailed in section DEVICE DRIVER EMULATION. 


12.0 MONITOR SUPPORT 


The emulator should support the Apple's built-in ROM Monitor. Entry to the Monitor 
should be similar to how this is done on a real /// (at startup if Open Apple and 
Control keys are pressed). The code in the ROM which tests for Monitor entry should 
work. 


13.0 APPLE ] [ EMULATION DISK SUPPORT 


It would be nice if the /// emulator supported the Apple ][ Emulation Disk. I'm not 
sure of what would be involved here but suspect that if the ///'s 6502 CPU and the 
memory-mapped I/O locations are robustly supported that the ][ emulation should work 
also without any special additional /// emulation features. 


Special consideration may need to be given to Apple /// keyboard keys which do not 
exist in the Apple ][ world. ][ emulation details can be found in the Apple /// 
Owner's Guide and the Apple /// Service Reference Manual. 


Note: I have a disassembled listing of the Apple ][ Emulation Disk ROM source listing 
which could prove useful in this area. 


Further analysis of the ][ emulation disk's boot sequence needs to be done since I'm 
unknowledgable about this area. Also, I've heard that the ][ emulation accesses an 
I/O location which disables some /// features. 


14.0 WHAT LANGUAGE SHOULD THE /// EMULATOR BE WRITTEN IN? 


I highly recommend that the /// emulator be written in a high level language such as 
Pascal or C. This should make the emulator more compatible with different target 
computers and make development and maintenance of the emulator much easier. I 
recommend avoiding low-level languages such as assembly. 


15.0 WHAT TARGET MACHINES SHOULD BE SUPPORTED? 


I recommend that the target machine (or machines) for the emulator be machines that 
are commonly used today by most computer users. This means either the IBM PC or the 
Apple Macintosh machine family. For the PC world I recommend the /// emulator run 
under Windows 95 and Windows NT. For the Macintosh world I recommend the emulator 
run on most Macintosh models which means support the Macintosh 512 and above. Color 
display should also be supported by the /// emulator (for the Macintosh this means 
use Color QuickDraw if the machine supports CQD and if CQD is not supported by a 
Macintosh model use the Classic B/W QD and maybe use patterns as "colors"). 
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Any of these machines should be fast enough to emulate the /// and most likely will 
be too fast in many areas. I recommend some type of speed control be built into the 
emulator so that users can control how fast the emulator works. For many /// 
programs (e.g. AppleWriter /// and VisiCalc ///) emulation speed will be immaterial 
since these programs typically wait for the user to enter data and then do their 
thing. But for programs such as games the user will want to control the emulator 
speed otherwise the game's actions will be super fast and unplayable. 


Some people say that the older machines such as pre-68040 Macintoshs will be too slow 
for a reasonable /// emulator. I would like to see this /// emulator run on a Mac 
512 machine an onwards. Running on a Mac 128 machine seems a problem due to this 
machine's small memory size and should not be supported (if a virtual memory scheme 
was used by the emulator the Mac 128 could be supported but I think having this extra 
level of support in the emulator would not be worth it). I disagree and am willing 
to wager a small sum that I'm right. 


16.0 EMULATOR DEBUGGING FACILITIES 


The emulator should support a comprehensive built-in debugger. This debugger's 
purpose should be to let the sophisticated emulator user access any part of the 
emulator's /// address space. This should include all of the memory that is 
allocated to the /// as its memory. This memory would encompass the 256K (or 512K) 
of /// RAM, the /// ROM (4K), the character set RAM (1K), the 6502 registers, and the 
special /// registers (e.g. bank register). 


This debugger will prove invaluable in diagnosing emulator bugs. Not only will the 
user be able to type commands for the debugger but the emulator will be able to send 
messages to the debugger. 


Logging of all debugger sessions should be stored to a text file for possible 
analysis. This text file would be created when the emulator starts. The log file 
should be appended to by the emulator. Only the user can delete the file. 


The debugger should exist as a separate window that does not in any way affect the 
emulator's main window. This window should display only commands that the user 
enters or replies returned by the debugger. There should not exist a separate window 
area showing things such as the 6502 registers since all such information should 
appear in the debugger log file. The window should support at least 80 columns of 
text and 24 rows. 


The emulator user interface should be based on a simple command line control scheme. 
All commands and command outputs should be text-based. This scheme could be based on 
the ///'s Monitor's commands or on a little more readable command scheme such as in 
Apple's MacsBug debugger. There should be full on-line help that discusses the 
debugger commands in general and each command should also have on-line help 
available. The debugger should show at the beginning of each line a prompt character 
to indicate when it is waiting for a command. I recommend the prompt be the ">" 
character. The debugger should also show a cursor which I recommend to be a black 
square. 


The debugger should support the standard debugging commands such as 
displaying/setting memory, displaying/setting registers, and disassembling 6502 
instructions. This disassembly should support the special SOS BRK call by listing 
the word "BRK/SOS" instead of just "BRK" and following this with the SOS command 
number/name and the parameter list address: 

SOS CO/CREATE 345A 
The user should be able to enable or disable this feature. 


Note: It may be good to also support the Apple ][ ProDOS command calling scheme in 
case this emulator ever becomes an Apple ][ emulator. 


The debugger should support break points, single stepping, and timing buckets. The 
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timing buckets would be used in conjunction with break points to record how long a 
sequence of 6502 instructions took to execute. This can be very useful in locating 
emulator bottlenecks. The debugger supports many break point commands since I have a 
feeling that this facility will be very powerful and useful during the emulator's 
development. 


The debugger should support the collection of statistics about the emulator. I 
recommend tracking how many times specific 6502 opcodes are executed (obviously, the 
debugger would need commands to display and clear this information). I would also 
track memory accesses on at least a page (256 bytes) basis. 


The debugger should be accessible at any time that the emulator is running. I 
recommend some type of key press combination that the emulator would detect and 
display the debugger window. Once the debugger window is active it should remain on 
the screen until the user closes the window. 


The emulator should also support a special key press combination at emulator startup 
time that activates the debugger just before the /// ROM is run. This can give the 
emulator developer a good way of tracing ROM execution. 


The emulator should activate the debugger if any fatal emulation errors are detected 
and the debugger should show a message detailing the reason for the activation. All 
of these errors display a dump of the 6502 and SOS control registers. Reasons for 
debugger activation from the emulator are: 


1. A program writes to write-protected memory (e.g. SOS's address space). The 
displayed message is "EMULATOR EXCEPTION: WRITING TO WRITE-PROTECTED MEMORY". 


2. A program executes an undefined 6502 instruction (e.g. 6502 opcode $02). The 
displayed message is "EMULATOR EXCEPTION: UNDEFINED 6502 OPCODE". 


When the debugger is initialized (which should be when the emulator starts) the 
debugger should check if a text file named "DDT.TXT" exists. If so, the debugger 
should read each line from this file and execute it. Obviously, this file should 
contain debugger instructions. This can be very useful for setting up commonly used 
break points which if you use many would be tedious to type everytime you wanted to 
use the emulator. 


A memory snapshot facility should also exist. When activated by a debugger command 
this facility would write to the host computer's disk a binary file containing a copy 
of all the /// memory areas. This snapshot should also be readable by the debugger 
so that the user could restart a specific emulation session from the snapshot. 


I recommend the following emulator debugger commands which are based on the /// 
Monitor commands so that these debugger commands will be familiar to Monitor users. 
These commands for the most part have the general syntax of address-command. See my 
document “Inside the Apple /// Computer ROM" for a list of the /// Monitor commands. 
For information about the Apple ][ Monitor commands, which the /// Monitor commands 
are based upon, see "Apple ][ Reference Manual" (Chapter 3: The System Monitor, dated 
1981). 


Addresses appearing in debugger commands may be prefaced by "N/" where N is a bank 
number. For example, to reference address 2000 of bank 4 use 4/2000. If no bank 
number precedes an address the current bank is used. To reference a ROM address use a 
bank "number" of "R", for example "R/F000". To reference a character set address use 
a bank "number" of "C", for example "C/0000". To reference the SOS system bank use 


"Ss", Gig. "Ss1d00". ) 
LK k 
Commands should be case-insensitive (none of the UNIX case-sensitivity gobbly-gook). 


Commands that display more than a screen full of information should either 
automatically pause when the screen is full, or the user can use the SPACE key. 


Note: Commands using ":" may also use ";" which is easier to type since this 
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character does not need the user of the shift key. Same for "<" and "/". 


Most debugger command numeric arguments must be specified in hexadecimal. The 
exception is the X command which supports hexadecimal, decimal, and binary. 


The debugger command parser should be very liberal. This means that users should be 
able to include extra spaces (or no spaces) and the command should be parsable. For 
example, if a command needs a list of bytes the user should be able to enter any of 
the following: "AABBCC", "AA BB CC", " A ABBC C " and the debugger will see these 
as "“AABBCC". 


The debugger should also support a command macro facility. This facility allows you 
to define a macro consisting of other debugger commands. Typing the name of the 
macro will then type the commands as if you entered them manually. 


Display debugger on-line help for all commands. Help info should be stored in an 
external text file for easier modification. I recommend that this section of this 
document be the help file. Clg ea aes ua et oie 


a~ Shows ait Lely +s fo all Cwnia HA 
Wace 


Return to the emulator. 


Example: BYE 


CARRIAGE RETURN keypress 
L206 
Repeat last command. 


Example: If the last command was HELP and you press the CARRIAGE RETURN key then HELP 
will be displayed and executed again. 


SPACE keypress 
& 2SPS 
Pause current command's output. Press again to continue. 


Example: If a command is executing and you press the SPACE key the comand's output 
will be paused, pressing SPACE again resumes the command's output. Pausing/Resuming 
are done on an output line basis only. 


DELETE keypress 


L LSP 
Stop current command's output. 


Example: If a command is executing and you press this key then the command will stop 
executing and you will be returned to the debugger's prompt. 


Show teble explaviany 
hry iy ? qud E 


Display 6502 registers and /// system control registers. 


Example: RD : - ys F over £ 
bit hames bid names ¥ cal 
A=04 eo Y=D8 Bey er, S=F8 PCc=034A : Bret See EMS Re Z=1A B=03 ‘ 
1 T R 
{sf Ned e sweat 0 ort an 
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byte:SY 


Set 6502 Y register to byte. 


byte:Ss 


Set 6502 


word:SPC 
Set 6502 PC register to word. 


Example: 2000:SPC re 


byte:SE 
Set /// E system control register to byte. 


Example: 34:SE eae rat 


Set /// Z system control register to byte. 


Example: 19:SZ 


byte:SB 
Set /// B system control register to byte. 


Example: 06:SB Pa 
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addri.addr2 


Dump memory data to screen from address 1 to address 2 and display ASCII character at 
the right of the screen. 


Pera a aE : ie - 
Example fassumes current bank is bank 4): 300.30F “De Cassanryy ae | Yn 


0 2B eee buenas) 
4/0300- B900 080A OAQA 9900 08C8 DOF4 A62B A909 [F..d.uy%*&90@. .G] 


Dump the contents of the current interpreter's Zero Page (256 bytes). Also supported 
are commands for the Stack Page and the Extend Page: 


SPAGE 7 stack page 
EPAGE - extend page 


To dump the pages for SOS (and drivers) use the following commands: 
SZPAGE . zero page 
SSPAGE - stack page 
SEPAGE - extend page 
Example: ZPAGE 
zero Page (interpreter) 
6G ' 2344 F 6A 
0123456789ABCDEF 0123456789ABCDEF 0123456789ABCDEF 01234567 89ABCDEF 
0123456789ABCDEF 0123456789ABCDEF 0123456789ABCDEF 01234567 89ABCDEF 


0123456789ABCDEF 0123456789ABCDEF 0123456789ABCDEF 0123456789ABCDEF 


addr: bytes 
Store starting at the address the bytes. 


Example: 2000:AA BB CC DD EE FF 
2000 : AABBCCDDEEFF 


addr: 'text' 


Store text starting at address (high bit clear). 
Example: 2000:'Hello World' ae eS 2 
2000:'David''s Dog' fs Ghis stores) Davia's Dog 


addr: "text" 


Store text starting at address (high bit eas pe 


Example: 2000:"Hello World" 
on: “bai cone ical ae 4 David's Yes 


addr3<addri1.addr2M 


Move data in address range to address 3. 


Example: 2000<3000.3100M — Oe 
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addr3<addril.addr2v 
Verify data in address range equals data starting at address 3. 
Example: 2000<3000.3100V Bon) ere 


Displays either "OK" if the verification suceeds, or "MISMATCH" if the verification 


bytes<addri1.addr2s 
Search memory in address range for the bytes. 


Example: AA<3000.3100S -- gearches for byte AA 
AABBCC<3000.3100S -- searches for bytes AA BB CC 


If a search finds a match then the starting address of the match is displayed, 
otherwise "PATTERN NOT FOUND" is displayed. 


7 
Pony pound AT atilr 


'text'<addri.addr2s 
Search memory in address range for text (high bit clear). 
Example: 'D'<3000.31005S it, 
'David'<3000.3100S 
"text"<addri1.addr2s 
Search memory in address range for text (high bit set). 
Example: "D"<3000.3100S 
"David"<3000.31008S 
disk. block<addri.addr2w 
Write address range to disk # disk starting at disk block. If disk # is not present 
then uses disk .Dl. Disk should equal 1, 2, 3, or 4. The address range always ends 
on a block boundary no matter what you type. 
Example: 1.117<2000.21FFW -- write 512 bytes to disk 1 block $117 
Note: Disk /// disks contain 280 blocks ($118) sot he block range is 0-117 
(hexadecimal). 
disk. block<addri1.addr2R 


Read from disk # disk starting at block to the address range. If disk # is not 
present then uses disk .D1. See the W command for more info. 


Example: 1.117<2000.21FFR cm read 512 bytes from disk 1 block $117 
ae 
disk.block-block:DISK 


Read block range from disk # disk to a special debugger 4K buffer which is not used 
by the emulator. If the typed block range is greater than 4K then only the first 4K 
will be read. You can then examine this buffer's contents either with a hex/ascii 
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dump or with a disassembly (command L). This command is useful when you want to 
examine a disk's contents. For disassembly purposes, you can specify the logical 
starting address for the buffer. See the DISKBUFFER command. 


To disassemble the special disk buffer (see the L command) use bank X (stands for 
"extra") as part of the disassembly address parameter (e.g. "X/100"). Same for 
dumping memory or whatever commands you want to use with this special buffer. 


Example: 1.0-7:DISK -- read 8 blocks (0 to 7) from disk 1 


addr : DISKBUFFER 


Set disk buffer starting logical address. Default address is 2000. See the DISK 
command. { 


Example: A000:DISKBUFFER Kange ts COOO-FFF 


addril.addr2L 


Disassemble instructions in address range. If only addril appears then disassemble 20 
instructions. Disassembly includes the opcode cycle count. 

Example: 300L -- assumes bank 4 is current 

4/0300- Ag Mat (2) LDA #$C1 
4/0302- 20 eae (5) JSR SFDED 
4/0305- 18 re (2) CLC 
4/0306- 69 2a (4) ADC #$01 
4/0308- cg vals (3) CMP #$DB 
4/030A- DO Mad (3) BNE $0302 
4/030C- 60 “Ue (4) RTS 


1 2 3 4 5 (see Note) 


bank register/address 

memory bytes 

ASCII for the memory bytes 

opcode cycle count 

disassembled instructions 

remark character ";" (optional, see DISASMREM) 


Column 
Column 
Column 
Column 
Column 
Column 


tou de ue a ut 


L by itself disassembles the next 20 instructions. 


DISASMREM 

Display ";" after each disassembly line that is produced by the L command. Default 
is to not display the remark. Useful if you plan to add comments to a disassembly. 
See also DISASMREMOFF. 


Example: DISASMREM 


DISASMREMOFF 
Turn off DISASMREM. See also DISASMREM. 


Example: DISASMREMOFF 
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Call subroutine at the address. 


Example: AOQ00G 


Jump to the address. 


Example: A0Q00J - 


Convert word (or up to 4 hex digits) to hexadecimal, decimal, and binary (X stands 
for "translate"). Prefix character for byte determines its base: ,no prefix = hex, 


= dec, t = binary. Yut ri, Pere oe 


Example: AX -> A(16) 10(10) 0000 0000 0000 1010(2) Caster Vitiwil 
.10X -> A(16) 10(10) 0000 0000 0000 1010(2) 7 
t1010 -> A(16) 10(10) 0000 0000 0000 1010(2) 
FFFFX -> FFFF(16) 65535(10) 1111 1111 1111 1111(2) 


addri1.addr2:cs 


Calculate and display a checksum for address range. Checksum is a 4 byte quantity 
which is calculated the same as the disk image file checksums. 


Example: 300.500:CS IE Neal 
CHECKSUM=AF897 CEE 


Trace instructions starting at the address. Each traced instruction displays 
register contents. Press the SPACE to pause the trace, press DELETE to stop the 
trace. The displayed registers contain values _after_ the previously listed command 
executes. 


Example: AOOOT -- assuming bank 4 is current 


4/A000- AY Cl Le, Grae (2) LDA #$C1 

A=C1l X=01 Y=D8 P=30/00000011 S=F8 PC=A002 : E=77/01110111 Z=1A B=04 

4 /A002 - 20 ED FD Maiataee (5) JSR $FDED 

A=Cl X=01 Y=D8 P=30/00000011 S=F6 PC=FDED : B=77/01110111 4Z4=1A B=04 
Is bot ptmes bithanes 

Note: Press the DELETE key to stop the trace, SPACE to pause/resume. 


Single step trace starting at the address. After each step pause and wait for user 
to press SPACE to continue or DELETE to stop the single step. 


S 
Example: nooof )*>- assuming bank 4 is current 


4/A000- AS Cl TX ost (2) LDA #5C1 
A=C1. X=01 Y=D8 pP=30/00000011 S=F8 PC=A002 : E=77/01110111 Z=1A B=04 
is nome Mt eylhe 4 
Note: Press SS by itself to single step the next instruction, or press CARRIAGE 
RETURN to repeat the SS. 
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addr:BP 


Set a break point at address. When address is accessed the debugger is entered and 
displays the registers. Up to 100 break points should be supported. 


Example: AQ00:BP 


addr:BPCc 
Clear break point at address. 


Example: A0Q00:BPC 


Set a break point when a SOS call is made. 
executed. Same as MOO:BP. 


Example: SOS:BP 


Mopcode: BP 
Set a break point when opcode is executed. 


Example: M60:BP -- set break point when the RTS instruction (60) is executed. 


ROM: BP 
Set a break point when 


Example: ROM:BP 


addri1.addr2:BPW 


Set a break point when any address within address range is written to. BPW = Break 
Point Write. 


Example: 300.123AR:BPW 


addrl.addr2:BPR 


Set a break point when any address within address range is read from. BPR = Break 
Point Read. 


: Lo 
; F 2 sri arr” 
Example: 300.123A:BPR ut L pie é 


addr. byte: BPE ddr cade is Wyte l bot Lia BPE (42 of tiers ( ) 


Set a break point when the address contents equal the byte value. BPE = Break Point 


Equals. 


allel - Ri? ® hotel -4,% ¢Z “ AE (a2 of ard 


Example: 300.AA:BPE 


addr .bytel1-byte2:BPE 


Set a break point when the address contents equal a byte value in the byte range. BPE 
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hel Crd 
pPNE 16 not eon als 


Same soetsy 4s BPE 


= Break Point Equals. 


Example: 300.AA-BB:BPE 


addr.bytei byte2 ... :BPEA ~2-—~" 


Set a break point when the address contents equal byte 1 value, or equals byte 2 
value, etc. Supports up to 16 byte values. BPEA = Break Point Equals Any. 


Example: 300.AABBCCDD:BPEA 
300.AA BB CC DD: BPEA 
addri.addr2.bytel1 byte2 ...:BPEA mek eee 


Set a break point when the address range contains any bytes equalling the byte 
values. BPEA = Break Point Equals Any. 


Example: 300.400.AABBCCDD: BPEA 


Set a break point when the address range contents equal the byte range. BPEA = Break 
Point Equals Any. 


Example: 300.400.AA-BB:BPEA 


Display break point table. 
Example: BPD 
# Address Range BP Setting 


1 4/2000-4/21FF BPEA AA-BB 


Clear break point table. 


Example: BPC 


addri.addr2:TB 


Set timing bucket for address range. When address 1 is accessed timing starts. When 
address 2 is accessed timing stops. Up to 100 timing buckets should be supported. 


Example: AQ0QQ.A1FF:TB 


Display timing bucket table. Shows all set timing buckets and the time in 1/60th of 
a second and in seconds spent in each bucket. 


Example: TBD 


# Address Range Time (1/60s) Time (secs) 
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1 4/A000-4/A1FF 
2 4/A300-4/A310 


addr: TBC 
Clear timing bucket starting at address. 


Example: A0Q00:TBC 


Clear timing bucket table. 


Example: TBC 


error:SOSE 

List SOS general error message for the error number. If no error number is present 
then list all general errors. Error info should be stored in an external text file 
for easier modification. See the SOS Reference Manual for a list of these errors. 
Example: 01:SOSE 


BADSCNUM - Invalid SOS call number 


error: SOSFE 


Display SOS fatal error message for the error number. If no error number is present 
then list all fatal errors. See the SOS Reference Manual for a list of these errors. 


Example: 01:SOSFE 


BADBRK - Invalid BRK 


command: SOS 

Display SOS command name and SOS command area (e.g. file system) for the command 
number. If no command number present then list all SOS command numbers and their 
names. Command info should be stored in an external text file for easier 
modification. See the SOS Reference Manual for a list of these commands. 
Example: C0:SOS 


CREATE (File System) 


Turn on disassembly of SOS calls which displays SOS followed by the command number 
and parameter address. The emulator defaults to this. 


Example: SOSON 


SOSOFF 
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Turns off SOSON. 


Example: SOSOFF 


disk:CAT 


Display catalog of SOS disk stored in disk # disk. Includes recursive list of all 
subdirectories. Should show same file info as Apple's System Utilities program. 


Note: Other commands that may be supported include CATPASCAL for Apple ][ Pascal 
disks and CATDOS for Apple ][ DOS disks. This may come in handy if you want to see 
what these disks contain if you have them as disk image files. 


Example: 1:CAT 


disk.file_name: INFO 

Displays information about the specified file in the disk. Information includes 
standard SOS file information but also block list of all index blocks (if any) 
associated with the file and block list of all data blocks for the file. 


Example: 1.APPLE3.TEXT: INFO 


disk. block: DUMP 
Display contents of specified disk block in the standard hex/ascii dump format. 


Example: 1.0:DUMP 


disk: DRIVERS 

Display list of contents of the SOS.DRIVER file stored on the disk. List includes 
driver names, driver information, and other items that are in the driver file (e.g. 
character sets). 


Example: 1:DRIVERS 


disk: CHECKIMAGE 


Check validity of disk image in disk # disk. Computes header and data part checksums 
and compares against the image file's listed checksums. 


Example: 1:CHECKIMAGE 


Display Driver Information Table (DIT), a data structure maintained by this debugger. 
Contains list of all loaded drivers, their names, sizes, and entry point addresses. 


Example: DIT 


Display Memory Information Table (MIT), a data structure maintained by this debugger. 
See section EMULATOR MEMORY STRUCTURE for what this structure contains. 


Example: MIT 
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OPCODES 


Display a histogram of opcode execution counts. Includes the actual number of the 
counts. Sorted by frequency. Opcodes not executed are listed below the histogram. 


Example: OPCODES 


LDA 2,188,973 KKERKKREKREEKKEERKREEEKEEKRKEKEKRKERKKKEKKKKRKKK KKK RRR 
STA 12,123 KRREKKKEKKERKEKKKKKEEKEEKKEKK RR KKKEE 
KEKKEKKKKKKKKEKK 


2,201,563 


Unexecuted opcodes: TXS NOP 


OPCODESCLR 
Reset opcode histogram table. 


Example: OPCODESCLR 


pagel .page2 : MEMORYR 

Display memory write access table. This table lists on a 256 byte page basis counts 
for each time the page was read. If pagel.page2 specified then lists only those 
pages. If a single page is specified then display only that page's access count. 


Example: 0.5:MEMORYR 


pagel .page2 : MEMORYW 


Display memory read access table. This table lists on a 256 byte page basis counts 
for each time the page was written. See MEMORYW for page options. 


Example: 0.5:MEMORYW 


MEMORYCLR 
Reset both memory access tables. 


Example: MEMORYCLR 


36 : f< 
value: SCROLL iL stk yO ten Cundy Sle Kore dh ore 
eo tle ee Pins md wl 


anew 
Set debugger display scrolling rate interline delay. Value is in 1/10th of a second. u 
Default is no delay (value = 0). Useful if you want to for example dump lots of 
Memory and don't want to mess with the SPACE key to read what is displayed. Set the 
scrolling delay to a comfortable value, sit back, and enjoy the show. 


pm [hbeen 


Example: 10:SCROLL -- gets scrolling delay to 1 second 


filename: LOG 
Close log file, create a new one with filename, and output all debugger displays to 


this new file. Useful if you're running the emulator from a write-protected disk and 
you want to re-direct the output to a writable disk file. 
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Example: MyDiary:LOG 


SNAPSHOTW 

Write the contents of all of the emulator's memory to binary file on the host 
computer's hard disk. This snapshot could prove useful in diagnosing an emulator 
problem. The binary file should be named "Snapshot_YYYYMMDD_HHMMSS.BIN". 


Example: SNAPSHOTW 


SNAPSHOTRfile-name 
Read a snapshot file into the emulator's memory. 


Example: SNAPSHOTR Snapshot_19971225_123456.BIN 


MACRO name commands 

Define a macro name and commands for this macro. You can use any name containing 
alphnumeric characters or periods with a maximum length of 31 characters. Up to 25 
macros may be defined. All commands are verified and if any syntax errors occur you 
will be told and the macro will not be defined. Macro commands cannot include other 
macro commands. 


Example: MACRO my.dump 300.400 A000.A1FF AOOOL 


List all defined macros. 
Example: MACROL 


# Name / Contents 


Imacro -name 


Execute a macro with the name “macro-name". Each command within the macro is 
displayed followed by the commands' display. 


Example: !my.dump 
300.400 
A000. A1FF 
AOOOL Cher 
poet — dirpley Curnet fd trap pow? PIA Kur fou btnep 
VERSION 


Display debugger version information. Includes version number and creation 
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17.0 EMULATOR MEMORY STRUCTURE 


I recommend that the emulator's internal memory structure for the Apple /// memory 
resources be structured as follows: 


oO Memory block containing the size of memory and references to each /// memory bank 
(the references can be whatever is appropriate -- on the Mac these could be Mac 
memory pointers or handles): 
- number of switchable banks (1..15) 
reference to bank § (32K: QOO0-1FFF, AOQO-FFFF) * 


reference to bank 0/S0 - switchable (32k: 2000-9FFF) 
reference to bank 1/$1 - switchable (32k: 2000-9FFF) 


reference to bank 14/$E - switchable (32k: 2000-9FFF) 


reference to Boot ROM ROM address space (4k: FOOO-FFFF) 
reference to Boot ROM RAM address space (4k: FOOO-FFFF) 


- reference to I/O RAM address space (4k: CO00-CFFF) 


* The system (S) bank is always on-line and is never bank switched. SOS and part of 
the interpreter reside here. 


© Memory block containing the 6502 registers: 

Accumulator (A) bits 

X index (X) bits 

Y index (Y) bits 

Status Register (P) bits 

Stack Pointer (S) bits 

Program Counter (PC) 16 bits 

Memory block containing the special /// System Control Registers: 

E: Environment Register (FFDF) 8 bits 

Z: Zero Page Register (FFDO) 8 bits 

B: Bank Register (FFEF) 8 bits 

WHAT'S NEXT? 

Persons seriously interested in creating an Apple /// emulator program should try to 
obtain as much /// technical information as possible. The author has lots of info 
which he can copy at minimal charge (10 cents per page plus postage). These persons 


should also have access to a working Apple /// computer with a fair number of /// 
programs. 


Other areas of compatibility should also be investigated that this document does not 
address. This includes support for other input devices such as the mouse which does 
have a 3rd party driver available. 
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Apple /// SOS Technical Information 


SOS 1.3 
Floppy Bootstrap Loader 
Source Code Listing 


This listing shows the code which is found at the beginning of 
a SOS boot disk. When the Apple /// computer starts the 
computer's ROM loads this code from the floppy disk 
and executes the code. This code loads the Apple ///'s 
operating system, SOS. 
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Ft i | 
7@ APPLE /// BOOTSTRAP LOADER FOR FLOPPY DISK 


@ - Disassembled 1@-March-1988 by Scott Stinson 
PFPTPTITTITIT IT TTT TTT ttt tT 


Cbd eo eeKeeKeK eee eE KEES 


- ABSOLUTE 
«PROC BOOTSTRAPLOADER 
«ORG LALBOS 


IBDRVN DRIVE NUMBER 

IBTRK TRACK NUMBER 

IBSECT ; SECTOR NUMBER 

IBBUFP ; BUFFER POINTER 

IBCMD ; COMMAND NUMBER 

IBBUFPTMP ; BUFFER POINTER TEMPORARY 
FILECNT ; FILE COUNT 

INDXBLKCNT ; INDEX BLOCK COUNT 

SOS JMPADR ; SOS JUMP ADDRESS 


SCREENLOC ; SCREEN LOCATION 
KBDSTROBE KEYBOARD STROBE 
IOBEEP ; I/O BEEP 


RETINT RETURN FROM INTERRUPT 

IDXBLK1 INDEX BLOCK 1 

IDXBLK2 ; INDEX BLOCK 2 

LOADADR ; LOADING ADDRESS 

OFFSET ; OFFSET 

FIRSTPAGE ; FIRST PAGE 

MAINBUFF ; MAIN BUFFER 

REGRWTS READ/WRITE SECTOR ROUTINE 

SECTABL SECTOR TABLE 

NMIVECTOR NON-MASKABLE INTERRUPT VECTOR 
ENVIRONMENT REGISTER 
BANK REGISTER 


SET INTERRUPT DISABLE 
CLEAR DECIMAL FLAG 
LOAD ACCUMULATOR WITH $77 
STORE IN ENVIRONMENT REGISTER 
SET 2 MHZ, I/O SPACE ENABLED, SCREEN ENABLED, 
; RESET ENABLED, WRITE PROTECT NOT ENABLED, 
; PRIMARY STACK, AND ROM SELECTED 
LOAD ACCUMULATOR WITH $FF 
; TRANSFER X-REGISTER TO STACK POINTER 
KBDSTROBE ; CLEAR KEYBOARD 
#RETINT ; LOAD ACCUMULATOR WITH RETURN FROM INTERRUPT 
NMIVECTOR ; STORE IN NON-MASKABLE INTERRUPT VECTOR 
#27 LOAD ACCUMULATOR WITH $27 
BREG ; STORE IN BANK REGISTER 
#2 ; LOAD ACCUMULATOR WITH $8 
BREG ; DECREMENT BANK REGISTER 
FIRSTPAGE STORE IN FIRST PAGE OF BANK 
FIRSTPAGE ; LOAD X-REGISTER WITH FIRST PAGE BYTE 
BRANCH IF BYTE IS NOT EQUAL TO $@@ 


READSOSDIR LDA ; LOAD ACCUMULATOR WITH $@@-BLOCK HIGH BYTE 
STA ; STORE IN BUFFER POINTER LOW BYTE 
LDX ; LOAD X-REGISTER WITH $A2 
STX IBBUFP+1 ; STORE IN BUFFER POINTER HIGH BYTE 
LDX #22 LOAD X-REGISTER WITH $@2-BLOCK LOW BYTE 
RDSOSDIRLP LDY IBBUFP LOAD Y-REGISTER WITH BUFFER POINTER LOW BYTE 
STY IBBUFPTMP ; STORE IN BUFFER POINTER TEMPORARY LOW BYTE 
LDY IBBUFP+1 LOAD Y-REGISTER WITH BUFFER POINTER HIGH BYTE 
STY IBBUFPTMP+1 ; STORE IN BUFFER POINTER TEMPORARY HIGH BYTE 
JSR READBLK JUMP TO READ A BLOCK FROM FLOPPY DISK DRIVE 
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#92 
@IBBUFPTMP, Y 


LOAD Y-REGISTER WITH $22 

LOAD ACCUMULATOR WITH NEXT BLOCK TO READ LOW 
BYTE 

TRANSFER ACCUMULATOR TO X-REGISTER 

INCREMENT Y-REGISTER 

LOAD ACCUMULATOR WITH NEXT BLOCK TO READ HIGH 
BYTE 

BRANCH IF NEXT BLOCK TO READ HIGH BYTE IS NOT 
EQUAL TO ZERO 

CHECK TO SEE IF NEXT BLOCK TO READ LOW BYTE IS 
2ERO 

BRANCH IF NEXT BLOCK TO READ LOW BYTE IS NOT 
EQUAL TO ZERO 


@IBBUFPTMP,Y 
RDSOSDIRLP 
#20 


RDSOSDIRLP 


rere rae Tecra ee Te Tate Tecan Ty 


SRCHSOSKER LDA MAINBUFF+25 LOAD ACCUMULATOR WITH FILE COUNT LOW BYTE 
STA PILECNT STORE IN FILE COUNT LOW BYTE 
LDA MAINBUFF +26 LOAD ACCUMULATOR WITH FILE COUNT HIGH BYTE 
STA PILECNT+1 STORE IN FILE COUNT HIGH BYTE 
ORA PILECNT OR ACCUMULATOR WITH FILE COUNT LOW BYTE 
BNE $910 BRANCH IF FILE COUNT IS NOT EQUAL TO ZERO 
UMP WRNTFNDERR JUMP TO WRITE NOT FOUND ERROR MESSAGE TO 
SCREEN 
LDA FILECNT LOAD ACCUMULATOR WITH FILE COUNT LOW BYTE 
BNE $820 BRANCH IF NOT EQUAL TO S@@ 
DEC FPILECNT+1 DECREMENT FILE COUNT HIGH BYTE 
DEC FILECNT DECREMENT FILE COUNT LOW BYTE 
LDA #23 LOAD ACCUMULATOR WITH $28 
STA IBBUFP STORE IN BUFFER POINTER LOW BYTE 
LDA #OA2 LOAD ACCUMULATOR WITH SA2 
STA IBBUFP +1 STORE IN BUFFER POINTER HIGH BYTE 
LDX MAINBUFF+24 LOAD X-REGISTER WITH ENTRIES PER BLOCK 
DEX DECREMENT X-REGISTER 
SRCHLP LDY #20 LOAD Y-REGISTER WITH $9 
LDA @IBBUFP, Y LOAD ACCUMULATOR WITH STORAGE TYPE AND NAME 
LENGTH BYTE 
BEQ $929 BRANCH IF EQUAL TO ZERO 
AND #OP MASK OFF BITS 4,5,6,7 
CMP FLNMELEN COMPARE WITH FILE NAME LENGTH 
BNE $229 BRANCH IF NOT EQUAL TO ZERO 
TAY TRANSFER NAME LENGTH TO Y-REGISTER 
LDA @IBBUFP, Y LOAD ACCUMULATOR WITH FILE NAME BYTE 
CMP FLNME~1, Y COMPARE WITH FILE NAME BYTE 
BNE $829 BRANCH IF NOT EQUAL 
DEY DECREMENT NAME LENGTH 
$B19 BRANCH IF NAME LENGTH NOT EQUAL TO ZERO 
@IBBUFP,Y LOAD ACCUMULATOR WITH STORAGE TYPE AND NAME 
LENGTH BYTE 
#OFO MASK OFF BITS 2,1,2,3 
#28 COMPARE WITH $2@ FOR SAPLING FILE 
READIDXBLK BRANCH IF EQUAL TO READ INDEX BLOCK 
PUSH PROCESSOR STATUS ON STACK 
DECREMENT ENTRIES PER BLOCK 
$930 BRANCH IF ENTRIES PER BLOCK IS EQUAL TO ZERO 
CLEAR CARRY 
IBBUFP LOAD ACCUMULATOR WITH BUFFER POINTER LOW BYTE 
MAINBUFF+23 ADD ENTRY LENGTH LOW BYTE 
IBBUFP STORE IN BUFFER POINTER LOW BYTE 
IBBUFP +1 LOAD ACCUMULATOR WITH BUFFER POINTER HIGH BYTE 
#20 ADD $20 
IBBUFP +1 STORE IN BUFFER POINTER HIGH BYTE 
$848 BRANCH ALWAYS 
#4 LOAD ACCUMULATOR WITH $24 
IBBUFP STORE IN BUFFER POINTER LOW BYTE 
IBBUFP+1 INCREMENT BUFFER POINTER HIGH BYTE 
MAINBUFF+24 LOAD X~REGISTER WITH ENTRIES PER BLOCK 
PULL PROCESSOR STATUS FROM STACK 
SRCHLP BRANCH IF NOT EQUAL TO ZERO 
SET CARRY 
FILECNT LOAD ACCUMULATOR WITH FILE COUNT LOW BYTE 
#91 SUBTRACT $81 
PILECNT STORE IN FILE COUNT LOW BYTE 
FILECNT+1 LOAD ACCUMULATOR WITH FILE COUNT HIGH BYTE 
420 SUBTRACT $2@ 
FILECNT+1 STORE IN FILE COUNT HIGH BYTE 
SRCHLP BRANCH IF MORE FILE ENTRIES 
WRNTFNDERR JUMP TO WRITE NOT FOUND ERROR MESSAGE TO 


reads in the index block of the SOS.KERNEL file. 


READIDXBLK LDY LOAD Y—-REGISTER WITH $11 
LDA @IBBUFP,Y LOAD KEY POINTER LOW BYTE 
TAX TRANSFER ACCUMULATOR TO X-REGISTER-BLOCK LOW 
BYTE 
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INCREMENT Y-REGISTER 

LOAD KEY POINTER HIGH BYTE 

LOAD Y-REGISTER WITH $02 

STORE IN BUFFER POINTER LOW BYTE 

LOAD Y-REGISTER WITH $gC 

STORE IN BUFFER POINTER HIGH BYTE 

JUMP TO READ A BLOCK FROM FLOPPY DISK DRIVE 


@IBBUFP, Y 
#20 
IBBUFP 
#2C 
IBBUFP+1 
READBLK 


RD1SOSKER IDXBLK1 LOAD X-REGISTER WITH INDEX BLOCK LOW BYTE 
IDXBLK2 LOAD ACCUMULATOR WITH INDEX BLOCK HIGH BYTE 
#00 LOAD Y-REGISTER WITH $e 
IBBUFP STORE IN BUFFER POINTER LOW BYTE 
#1E LOAD Y-REGISTER WITH $1E 
IBBUFP+1 STORE IN BUFFER POINTER HIGH BYTE 
READBLK JUMP TO READ A BLOCK FROM FLOPPY DISK DRIVE 


This section does a verification of the SOS.KERNEL file to make 
sure it is the proper SOS.KERNEL file. It checks for "SOS KRNL" in 
the first 8 bytes of the file. 


AD 28 FLVRFY LOAD Y-REGISTER WITH $28 

B9 FF1D FLVRFYLP LOADADR-1, ¥ LOAD ACCUMULATOR WITH BYTE FROM SOS.KERNEL 

D9 9CAl FLVERIFY-1,¥ COMPARE WITH VERIFICATION BYTE 

F223 $218 BRANCH IF EQUAL 

4C 6AA1 WRINKERERR JUMP TO WRITE INVALID KERNEL ERROR MESSAGE TO 
SCREEN 

88 DECREMENT Y-REGISTER 

DOF 2 FLVRFYLP BRANCH IF NOT EQUAL TO 2ERO TO CHECK REST OF 8 
SOS.KERNEL BYTES 


RDSOSKER LOAD ACCUMULATOR WITH $21 
INDXBLKCNT STORE IN INDEX BLOCK COUNT 
RDSOSKELP INDXBLKCNT LOAD Y-REGISTER WITH INDEX BLOCK COUNT 
IDXBLK1,Y LOAD X-REGISTER WITH BLOCK LOW BYTE 
IDXBLK2, Y LOAD ACCUMULATOR WITH BLOCK HIGH BYTE 
$018 BRANCH IF BLOCK HIGH BYTE IS NOT EQUAL TO ZERO 
#08 CHECK TO SEE IF BLOCK LOW BYTE IS NOT EQUAL TO 
ZERO 
JUMP SOSKER BRANCH IF BLOCK LOW BYTE IS NOT EQUAL TO ZERO 
READBLK JUMP TO READ A BLOCK FROM FLOPPY DISK DRIVE 
INDXBLKCNT INCREMENT INDEX BLOCK COUNT 
RDSOSKELP BRANCH IF INDEX BLOCK COUNT IS NOT EQUAL TO 
ZERO TO READ MORE OF THE SOS.KERNEL 


JUMPSOSKER CLC CLEAR CARRY 
LDA LOAD ACCUMULATOR WITH $E 

ADD OFFSET LOW BYTE 
STORE IN SOS JUMP ADDRESS LOW BYTE 
LOAD ACCUMULATOR WITH $1E 

OFFSET+1 ADD OFFSET HIGH BYTE 

SOSJMPADR+1 STORE IN SOS JUMP ADDRESS HIGH BYTE 

@SOSJMPADR JUMP TO SOS.KERNEL LOADER 


This section reads a block of data from the floppy disk drive. 
On entry the x~-register contains the block low byte and the 
accumulator contains the block high byte. 


READBLK STORE BLOCK LOW BYTE IN TRACK NUMBER 
DIVIDE BLOCK BY 8 TO GET TRACK NUMBER 


TRANSFER X-REGISTER WHICH CONTAINS THE BLOCK 
LOW BYTE TO ACCUMULATOR 

MASK OFF BITS 3,4,5,6,7 

TRANSFER ACCUMULATOR TO X-REGISTER 

LOAD ACCUMULATOR WITH PROPER SECTOR TO READ 
STORE IN SECTOR NUMBER 

LOAD ACCUMULATOR WITH $21 

STORE IN COMMAND NUMBER 

LOAD ACCUMULATOR WITH $20 

STORE IN DRIVE NUMBER 


SECTABL, X 
IBSECT 
#21 

IBCMD 

#00 
IBDRYN 
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22 QOFS REGRWTS 

9285 $210 

A2 FF #OFF 

9A 

B@3B WRDISKERR 

E6 86 IBBUFP+1 

E6 84 IBSECT 

E6 84 IBSECT 

22 QOS REGRWTS 
$O28 
#OFrF 


JUMP TO READ A SECTOR FROM FLOPPY DISK 
BRANCH IF NO DISK ERRORS OCCURED 

LOAD ACCUMULATOR WITH $FF 

TRANSFER X-REGISTER TO STACK POINTER 

BRANCH TO WRITE DISK ERROR MESSAGE TO SCREEN 
INCREMENT BUFFER POINTER HIGH BYTE 

INCREMENT SECTOR NUMBER 

INCREMENT SECTOR NUMBER 

JUMP TO READ A SECTOR FROM FLOPPY DISK 
BRANCH IF NO DISK ERRORS OCCURED 

LOAD ACCUMULATOR WITH $FF 

TRANSFER X-REGISTER TO STACK POINTER 

BRANCH TO WRITE DISK ERROR MESSAGE TO SCREEN 
INCREMENT BUFFER POINTER HIGH BYTE 

RETURN TO CALLER 


WRDISKERR 
IBBUFP+1 


eee i er Tere Te yy 


A2 1B WRNTFNDERR LDX LOAD X-REGISTER WITH $1B 

AS 21 LDY ; LOAD Y-REGISTER WITH $21 

BD A4Al $018 LDA NTFNDERR-1,X ; LOAD ACCUMULATOR WITH NOT FOUND ERROR MESSAGE 
; BYTE 

99 2826 STA SCREENLCC, Y WRITE IT TO THE SCREEN 

88 DEY DECREMENT Y~REGISTER 

CA DECREMENT X-REGISTER 

DOF6 BRANCH IF MORE CHARACTERS TO WRITE ON SCREEN 

AD 49C@ BEEP SPEEKER 

4C 67Al HANG FOREVER !! 


A2 13 WRINKERERR LDX ; LOAD X-REGISTER WITH $13 
A® 1D LDY LOAD Y-REGISTER WITH $1D 
BD BFA1 $210 LDA INVKEERR-1,X LOAD ACCUMULATOR WITH INVALID KERNEL ERROR 

MESSAGE BYTE 
99 2886 STA SCREENLOC, Y WRITE IT TO THE SCREEN 

DEY DECREMENT Y-REGISTER 
DECREMENT X-REGISTER 
; BRANCH IF MORE CHARACTERS TO WRITE ON SCREEN 

AD 42C@ ; BEEP SPEEKER 
4c 7BAl ; HANG FOREVER !! 


WRDISKERR LOAD X-REGISTER WITH $@A 
LOAD Y-REGISTER WITH $18 
$018 DISKERR-1, X LOAD ACCUMULATOR WITH DISK ERROR MESSAGE BYTE 
SCREENLOC, Y WRITE IT TO THE SCREEN 
DECREMENT Y-REGISTER 
DECREMENT X-REGISTER 
; BRANCH IF MORE CHARACTERS TO WRITE ON SCREEN 
BEEP SPEEKER 
; HANG FOREVER !! 


FLNMELEN 
FLNME # "SOS .KERNEL" 


FLVERIFY "SOS KRNL" 
NTFNDERR "FILE 'SOS.KERNEL' NOT FOUND" 


INVKEERR “INVALID KERNEL FILE" 


"DISK ERROR" 


AB ~ Absolute LB - Label UD - Undefined MC - Macro 
RF ~ Ref DF - Def PR - Proc FC - Func 
PB - Public PV - Private cS - Consts 


BOOTSTRA PR ---- | BREG AB FFEF | DISKERR LB A1D3 | ENTRY LB A@@@ | EREG AB FFDF | 
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FILECNT AB @@E5 
FLVRFY LB AGE2 


| FIRSTPAG AB 2200 FLNME LB FLNMELEN FLVERIFY 

| EFLVRFYLP LB A@E4 IBBUFP AB IBBUFPTM IBCMD 
IBDRVN AB 9282 | IBSECT AB @284 IBTRK AB IDXBLK1 IDXBLK2 
INDXBLKC AB 8@E7 | INVKEERR LB A1C@ IOBEEP AB JUMPSOSK KBDSTROB 
LOADADR AB 1E@@ | MAINBUFF AB A229 NMIVECTO AB NTFNDERR OFFSET 
RD1SOSKE LB A@D1 | RDSOSDIR LB A@2E RDSOSKEL LB RDSOSKER READBLK 
READIDXB LB A@BE | READSOSD LB A@24 REGRWTS AB RETINT SCREENLO 
SECTABL AB F4A@ | SOSJMPAD AB @@E8 SRCHLP LB SRCHSOSK WRDISKER 
WRINKERE LB Al6A | WRNTFNDE LB A156 


Assembly complete: 363 lines 
7] Errers flagged on this Assembly 


ka kkk 

x 
OOO OOK RIK 
ak 

* 

wa aK 

ae 

aK 

RAKE 

wake 

KaKKKK 

ak 

Bk Rk 

Rokk ke 

FOI OI IO IOI OIG tk tak 
FORO kk ake 
KKRRKKKKKAKKRE KK 
kak 


URN WN WS 


hs 


mew 
WEANADINAUNUWNAEN 


FORO OOOO IO Ik 
kk 

Rk kK KK 

wR 

m * 
m * 
KKK 


1 
1 
1 
3 
1 
2 
1 
1 
3 
2 
6 
3 
1 
1 
3 


Minimum frequency 
Maximum frequency 


Average frequency 
Unused opcodes: 


ASL BMI BPL BRK BVC BVS CLI CLV CPY EOR INX NOP PLA ROL RTI 
SED TSX TYA 


Program opcode usage: 


CFP F077 
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APPLE /// SOS BOOTSTRAP LOADER 
HEXADECIMAL DUMP 


Source 
DISK1.dofile as found with Chris Smolinski's Macintosh SARA emulator application 


Printed by David T. Craig » December 1997 


This hex dump, which was produced by the Apple Macintosh MPW DumpFile tool, lists the 
Apple /// SOS Bootstrap Loader. This 512 byte loader exists at block 0 of SOS disks and is 
loaded by the Apple /// ROM into memory addresses $A000-$A1FF. This code's purpose is 
to begin the loading of SOS from the floppy disk into the ///s memory. 


0: 6E AO 53 4F 53 20 42 4F 4F 54 20 31 2E 31 LntSOS.BOOT..1.1 
10: OA 53 4F 53 2E 4B 45 52 45 20 20 20 20 ..SOS.KERNEL.... 
20: 53 4F 53 20 4B 52 4E 4c 2F 20 45 52 52 .SOS.KRNLI/O.ERR 
30: 52 08 00 46 49 4c 45 20 53 53 2E 4B 45 OR..FILE.'SOS.KE 
40: 4E 45 4C 27 20 4E 4F 54 46 55 4E 44 25 RNEL' .NOT.FOUND% 
50: 49 4E 56 41 4c 49 44 20 AS 4E 45 4C 20 . INVALID. KERNEL. 
60: 49 45 00 Oc 00 OE 04 A4 78 D8 : §xy 
70: 77 DF FB 9A 2C Co 40 8D CA FF @wcfl’¢'d, .2@@c ~ 
80: 07 EF 00 CE EF 8E 20 AD 00 20 ©.c6°¢.a6"4. .#.. 
90: F5 o1 A9 00 85 AQ 85 85 AO A2 -1©.6+0.6-0. 660¢ 
AO: 86 BE FO AS 00 E6 86 F6 86 E6 OU. x°R1O.OREUEUE 
BO: 20 Al Bl 85 85 c8 85 85 El DO fi.x°t .406t»4006-- 
Co: AS DO 6C AQ 85 AD AO 85 E3 18 f++-f#4110,amtG,. 
DO: E3 02 38 AS E2 23 85 E4 A5 ES ¢,1.0A8*, T#8O%eA 
EO: 00 E5 Bl E2 29 cD AO DO 21 A8 EB.OAt.+,).6.+t-!® 
FO: E2 11 88 DO AO Bl E2 29 FO +,¥.t-.a-“t.+,)@ 

100: 4r 20 AC 62 O1 OF 2E 44 31 SOS.KRNLb 
110: 53 53 45 50 A5 AO F9 AO /SOS.INTERP™e t+ ~ t 
120: AS AQ AO 98 FO Al AO CC tettett=ttote°ta 
130: AO AO EE AO OF 2E 44 31 tt=tttttOttf..Dl 
140: 53 53 9A AO FF 9A /SOS.DRIVER™’6t”6 
150: AO AO AO F9 AO Cl tttt-ttittatt ti 
160: AO Al 00 00 88 OC Eta°tittetta..a. 
170: 00 9D 9D 00 18 9D ©.™..u..0..0..0 
180: 14 00 FF A2 FB 9A ..U.. -f@0cfl’¢’°s 
190: 1A DO 10 09 28 8D @.c—~.'.#AflY)..(¢ 
1A0: FF 19 8D EF FF fl’¢’60.¢-“#. .cO” 
1B0: 02 27 05 26 FO 1..™40°H40"+' .&6 
1c0: AS 65 27 85 23 3¢&-.A'A&.e#e' OF 
1D0: 25 Bl 22 91 24 e%e'OSF' §S@.4"6S 
1EO: DO C6 27 DO EC a-“t"SSAAHFASA'-I 
23 18 A5 24 65 10 85 10 B#BShcOY*.«Se.d. 


APPLE /// SOS BOOTSTRAP LOADER HEXADECIMAL DUMP »° Smolinski's Macintosh SARA emulator « 1 / 1 
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The Apple /il 


The Most Powerful Personal Computer In Its Class 


Too much information? Not enough 
time? The Apple /// was created to 
meet the information-handling needs 
of decision makers at all levels, in 
every size and kind of company. And 
the Apple /// can grow with you, so as 
your responsibilities increase, your 
ability to handle them stays one step 
ahead. 

You can use the power of your 
Apple /// to create financial forecasts, 
budgets, and reports; for accounting, 
resource management, and project 
scheduling; in electronic communi- 
cations, software development, and 
computer-assisted training. Over 400 
business programs are available today 
for the Apple /// — plus the extensive 
library of CP/M® business software 
(with the Apple SoftCard™ ///). And 
most Apple // Plus programs will run 
in the Apple ///'s “emulation” mode. 

The Apple ///: the personal com- 
puter for business. 


Powerful features for 
professional needs. 


The Apple /// is ready to go as soon 

as you unpack it, connect a monitor, 
and provide power. No interface cards 
are required, and you don't have to 
open the computer. The Apple /// 
already has a built-in disk drive, video 
outputs for color and monochromatic 
displays, and a numeric keypad. 
Other built-in features include: 


Large User Memory. The Apple ///'s 
256K of internal memory means you 
can work with sophisticated programs 
and large financial and text docu- 
ments, quickly and efficiently. 

Color Graphics. The 16-color graphics 
capability of the Apple /// allows you 
to grasp the meaning of charts and 
graphs quickly. If you’re not using 

a color monitor, your information is 
displayed in 16 shades, so the facts 
still stand out clearly. 

High-Resolution Video. The Apple /// 
displays 107, 520 points of information 
on the screen (560 horizontal x 192 
vertical) in text and monochromatic 
graphics modes. While text is normally 
presented in an 80-column by 24-line 
monochromatic format, it can be 
switched to 40-column monochro- 
matic or color-on-color. 


Accessory Connectors. The most 
common accessories plug right into 
the Apple ///. Connectors and inter- 
facing hardware are already built in 
for the Apple Daisy Wheel Printer 
(or other serial printer), the Apple 
Silentype Printer, external floppy 
disk drives, color and monochro- 
matic video displays (NTSC, RGB, 
and composite), a modem, and hand 
controls. The Apple /// also has four 
inside expansion slots for additional 
accessories. 


Apple //i Sophisticated 
Operating System: it does it 
all for you. 


Today... you can bring financial 
models into reports, insert names into 
form letters automatically, and turn 
numbers into charts, because the 
Apple //I's Sophisticated Operating 
System (SOS) treats all your files 
identically. And, since applications 
programs written for the Apple /// are 
all based on this common SOS for- 
matting, you can combine them on 

a ProFile™ mass storage system and 
move freely from one to another. The 
uniformity of SOS also provides an 
ideal environment for software 
development. 


COCCHI 
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Tomorrow ... you can expand your 
Apple /I/ elegantly. Because SOS 
controls all communications with 
accessories, you don’t have to figure 
out how to make the computer work 
with a new printer, disk drive, or 
modem. SOS does this for you by 
using special files known as “device 
drivers.” Apple /// programs come 
with the most commonly-used device 
drivers, and you can make programs 
compatible with new equipment by 
copying a driver file for the new device 
onto a program disk. Your software 
can just as easily be revised to take 
advantage of SOS upgrades, and 
of hardware enhancements to the 
computer itself. 


installation’s easy. 
Learning is, too. 


Because the Apple /// already has 

a built-in disk drive and video con- 
nector, the computer is ready to work 
as soon as you connect a monitor and 
provide power. Then, Apple makes it 
just as easy to learn how to use it. A 
comprehensive Owner's Guide gets 
you started, and a System Demonstra- 
tion disk introduces you to the com- 
puter’s text editing and graphics 
capabilities. Reference manuals and 
SOS utilities disks are included for 
more advanced needs, and additional 
tutorials on the computer and its 
programs are also available. 


Durable. Dependable. 
Reliable. 


The Apple /// is dependable, inside 
and out. Outside, it has a rugged die- 
cast aluminum chassis. Inside, elec- 
tronics based on advanced micro- 
processor circuitry assure reliable 
operation. The system also meets 
UL and CSA standards. 

Every time the computer is powered 
up, it performs a brief self-diagnostic 
routine. Should problems arise, help 
is close at hand, because of Apple’s 
extensive dealer/service network. 
Average turnaround time on Apple /// 
servicing is less than one day. 


Standard Features 
256K internal memory (RAM) 
Built-in disk drive 
Custom microprocessor circuitry 
High-resolution color graphics 
(16 colors) 
80-column, 24-line text display, 
upper and lower case 
Contoured typewriter-style key- 
board; 61 keys; all 128 ASCII codes; 
auto-repeat on all keys 
Numeric keypad (13 keys) 
Special-purpose keys: Up-Arrow, 
Down-Arrow, Left-Arrow, Right- 
Arrow; programmable Open-Apple 
and Solid-Apple; TAB; SHIFT; 
ALPHA LOCK; CONTROL; 
RETURN; ENTER; ESCAPE 
Quick-connect plugs for disk drives, 
video and audio devices, serial 
printers, modems, and hand 
controls 
Four expansion slots for accessory 
interface cards 
Apple // Plus emulation mode 
High-quality sound generation 
Lockable case 
Self-testing diagnostics on powerup 


Optional Accessories 

Monitor /// or color monitor 
Apple Daisy Wheel Printer 
Apple Dot Matrix Printer 
Apple Silentype Printer 
Disk /// floppy-disk drives 
ProFile hard-disk systems 
Apple SoftCard /// System 
(for CP/M capability) 
Parallel Card /// 

Serial Card /// 
Programming languages (Business 
BASIC, Pascal, COBOL) 
Cursor II! joysticks 


Cf Page 0169 of 0170 


Technical Specifications 
@ Video Display: 
Text and graphics may be displayed 
simultaneously. Graphics modes: 
—280 x 192, 16 colors (with some 
limitations); 
—280 x 192, monochromatic; 
—140 x 192, 16 colors; 
—560 x 192, monochromatic; 
—All Apple // modes (in emulation) 
Graphics commands allow either of 
two screen buffers to be displayed. 
Text modes: 
—80-column, 24-line mono- 
chromatic; 
—40-column, 24-line, 16-color 
foreground and background; 
—40-column, 24-line mono- 
chromatic. 
All text modes have a software- 
definable, 128-character set (upper- 
and lower-case), with normal or 
inverse display. 


® Central Processing Unit (CPU): 
The custom-designed microprocessor 
circuitry of the Apple /// utilizes the 
6502B as one of its major components. 
Other circuitry provides extended 
addressing capability, relocatable 
stack, zero page, and memory 
mapping. 
Type: 

6502B. 
Clock Speed: 


1.4 MHz average; 1.8 MHz maximum. 


Operations Per Second (8-bit): 
Up to 750,000. 

Data Bus: 
Two 8-bit formats, combined for 
extended addressing. 

Address Bus: 
19 bits. 

Address Range: 
262,144 bytes (256K). 

Registers: 
Accumulator (A); Index Registers 
(X,Y); Stack Pointer (S); Program 
Counter (PC); Environmental 
Register (E); Bank (B); Zero Page 
(Z); Processor Status (P). 


@ Memory: 

256K dynamic RAM; 

4K ROM (initialization and self-test 
diagnostics). 
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@ SOS (Sophisticated Operating 

System): 

Handles all system 1/0; 

Can be configured to handle standard 
or custom I/O devices and periph- 
erals by adding or deleting “device 
drivers”; 

All languages and application pro- 
grams access data through the SOS 
file system. 


@ /nputs and Outputs: 
Keyboard: 

—61 keys on main keyboard; 

—13 keys on numeric keypad; 

—Full 128-character, ASCII 
encoded; 

—All keys have automatic repeat; 

—Four directional-arrow keys with 
two-speed repeat; 

—Two user-definable Apple keys; 

—Seven other special keys: SHIFT, 
CONTROL, ALPHA LOCK, TAB, 
ESCAPE, RETURN, ENTER. 

Storage Devices: 

—One 5.25-inch floppy disk drive 
built in, 140K (143, 360) bytes per 
diskette; 

—Three additional drives can be 
connected by daisy-chain cable 
(Total: 560K bytes on-line 
storage); 

—Up to four ProFile hard-disk drives 
(5 megabytes each) may be added 
with plug-in interface cards. 

Video Output: 

—RCA phono connector for NTSC 
monochromatic composite video; 

—DB-15 connector for: 

NTSC color composite video; 

NTSC monochromatic composite 
video; 

RGB color video; 

Composite sync signal; 

Power supply voltages. 

—Color signals appear as 16-level 
grey scale on monochromatic 
displays. 

Audio Output: 

—Built-in two-inch speaker; minia- 
ture phono jack on back panel; 

— Driven by 6-bit D/A converter or 
fixed-frequency “beep” generator. 

Serial (Printer/Modem) Port: 

—RS-232C compatible, DB-25 
female connector; 

—Software-selectable baud rate and 
duplex mode. 

One port may be used for the 
Silentype printer. 
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One port may be used for the Silentype 
printer. 
Expansion: 

—Four 50-pin expansion slots (fully 
buffered, with interrupt and DMA 
priority structure). 

Joystick/Silentype Ports: 

—Two DB-9 connectors. 


@ Languages Available: 
Apple Business BASIC, Apple /// 
Pascal, Apple /// COBOL. 


@ Emulation Mode: 

Provides hardware emulation of 48K 
byte Apple // Plus. Allows most Apple // 
programs, with the exception of Pascal 
and FORTRAN, to run without 
modification. 


® Electrical Specifications: 

The Apple ///’s power cord should be 
plugged into a three-wire 110-120 volt 
outlet. 


@ Physical Specifications: 
Height: 4.8 inches (12.20 cm) 
Depth: 18.2 inches (46.22 cm) 
Width: 17.5 inches (44.45 cm) 
Weight: 26 Ibs. (11.8 kg) 

The Apple /// meets the following 

agency regulations: 

UL 114 — Office Appliances and 

Business Equipment. 

CSA 22.2, No. 154— Data Processing 

Equipment. 


The Apple /// Personal Computer 

System Package 

U.S. Order Number A3S0256 

With your order for an Apple /// 

System you will receive: 

256K Apple ///; 

Power cord; 

Monitor cable; 

System Demonstration disk; 

System Utilities disk; 

System Utilities Data disk (contains 
device driver files, character sets, 
and keyboard layouts); 

Apple // Plus Emulation disk; 

Owner's Guide; 

Standard Device Drivers Manual; 

Warranty and service information. 


Specifications or products may change without 
notice. 

Apple, the Apple logo, ProFile, and Silentype 
are trademarks of Apple Computer, Inc. 
SoftCard is a trademark of MicroSoft 
Corporation. 

CP/M is a trademark of Digital Research, Inc. 


PRINTED IN U.S.A. 


Fag 70- F077 


